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

• Identify the redirection file - Determine which .openpublishing.redirection.*.json file needs sorting.

• 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:

.\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 / ).