⚙️ [Maintenance]: Documentation index checks now work across line endings

[Marius Storhaug (MariusStorhaug)]

Documentation index checks now behave consistently across Windows and Linux working copies, avoiding false stale-index failures caused only by checkout line endings.

Fixed: Index checks no longer depend on checkout line endings

Current generated indexes pass validation with either LF or CRLF line endings. Real table-content drift still fails validation, and update mode retains one consistent existing newline style for the file.

Technical Details

• Normalizes line endings only for content comparison while rendering with the newline sequence detected from each existing index.
• Adds six focused Pester cases covering unchanged, stale, and updated LF and CRLF inputs.
• Preserves byte-for-byte content when an index is already current.
• Implementation plan progress: all line-ending behavior and validation tasks in Make documentation index checks line-ending agnostic #78 are complete.

Related issues

• Fixes Make documentation index checks line-ending agnostic #78

[Copilot]

Pull request overview

This PR updates the documentation index generation/check script to make “stale index” detection independent of the checkout’s LF vs CRLF line endings, preventing false CI failures across Windows/Linux working copies.

Changes:

• Normalize line endings only for comparison when determining whether an index is stale, while preserving the index file’s existing newline style when rendering/writing.
• Update index table generation to join lines using the detected newline sequence instead of forcing LF.
• Add Pester tests covering unchanged, stale, and repaired indexes under both LF and CRLF fixtures.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File	Description
tests/Update-DocumentationIndex.Tests.ps1	Adds fixture-based Pester coverage for LF/CRLF behavior in both -Check and update modes.
.github/scripts/Update-DocumentationIndex.ps1	Detects and preserves per-file newline style while comparing content in a newline-normalized form to avoid false stale detections.