Skip to content

Remove Uri sources from navigation rendering. #1546

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

Mpdreamz
Copy link
Member

@Mpdreamz Mpdreamz commented Jul 10, 2025

This PR removes the need to keep track of NavigationSource on markdown files to render the navigation.

Previous to this we needed the keep this around to track the 'real' parent of a section once it may have been reshuffled by navigation.yml.

We now more diligently build the global navigation more truthfully and can rely on walking the current navigation items .Parent to find the proper root to render.

This includes scrubbing/skipping phantoms from the navigation.

In particular this makes ‎src/tooling/docs-assembler/Navigation/GlobalNavigationHtmlWriter.cs a whole lot simpler.

Another step to refactoring our navigation acyclic graph as the single source of truth.

cursorful-video-1752141645394.mp4

This PR removes the need to keep track of NavigationSource on markdown files to render the navigation.

Previous to this we needed the keep this around to track the 'real' parent of a section once it may have been reshuffled by `navigation.yml`.

We now more diligently build the global navigation more truthfully and can relay on walking the current navigation items `.Parent` to find the proper root to render.

This includes scrubbing/skipping phantoms from the navigation.

Another step to refactoring our navigation acyclic graph as the single source of truth.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant