Skip to main content

sort-redirects

Sorts redirect entries in Open Publishing redirection JSON files alphabetically by path. Use after adding redirects or when the file becomes unsorted.

Source facts

Repository
dotnet/docs
Last source activity
February 20, 2026 at 19:26
Detected SKILL.md language
English
Stars
4,771
Forks
6,072

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
2 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
sort-redirects
description
Sorts redirect entries in Open Publishing redirection JSON files alphabetically by path. Use after adding redirects or when the file becomes unsorted.
# Sort Redirects Sort redirect entries in Open Publishing redirection JSON files alphabetically by path. This ensures consistency and makes the redirect files easier to maintain. ## When to Use - After adding redirect entries to a JSON file - When the redirect file has become unsorted - After merging branches that may have caused unsorted entries ## Steps 1. **Identify the redirection file** - Determine which `.openpublishing.redirection.*.json` file needs sorting. 2. **Run the sort script** - Use the `sort-redirects.ps1` script with the file path. ## Scripts ### sort-redirects.ps1 Sorts all entries in the JSON file alphabetically by path (ignoring leading `/` for `source_path_from_root`). Handles both `source_path_from_root` and `source_path` properties. Location (relative to this skill file): `./scripts/sort-redirects.ps1` | Parameter | Required | Description | |-----------|----------|-------------| | `RedirectionFile` | Yes | The path to a redirection JSON file (e.g., `.openpublishing.redirection.csharp.json`) | **Example:** ```powershell .\scripts\sort-redirects.ps1 -RedirectionFile ".openpublishing.redirection.csharp.json" ``` ## Important Notes - The script preserves all existing redirect entries, only changing their order. - Sorting is case-sensitive and alphabetical by the normalized path (without leading `/`).
View on GitHub