Implement version-specific MkDocs configuration for v0 and v1 documentation - #9
Merged
Merged
Conversation
Copilot created this pull request from a session on behalf of
gabriellewp
April 21, 2026 14:07
View session
Copilot
AI
changed the title
Add version-specific documentation navigation for v0 and v1
Deploy version-specific mkdocs configs to mkdocs branch
Jun 12, 2026
…yml (v1, with XAI nav), update workflow to use mkdocs-v0.yml for v0 build
Copilot
AI
force-pushed
the
copilot/update-mkdocs-version-dropdown
branch
from
June 12, 2026 18:49
c3eb002 to
f721355
Compare
Copilot
AI
changed the title
Deploy version-specific mkdocs configs to mkdocs branch
Implement version-specific MkDocs configurations for v0/v1 documentation builds
Jun 12, 2026
…docs-v0.yml config for v0 build
Copilot
AI
changed the title
Implement version-specific MkDocs configurations for v0/v1 documentation builds
Implement version-specific MkDocs configuration for v0 and v1 documentation
Jun 12, 2026
gabriellewp
marked this pull request as ready for review
June 13, 2026 17:52
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The v0 and v1 documentation dropdown links were displaying identical content regardless of selection. This PR implements separate MkDocs configurations to properly reflect version differences: v0 (AnnoRank) excludes XAI pages while v1 (XAnnoRank) includes them.
Changes
mkdocs-v0.ymlconfiguration: Stripped-down v0 config with navigation excluding XAI pages (XAI Configuration, XAI Ranking App, XAI UI Functionalities)mkdocs.yml: Explicit navigation structure for v1 that includes all XAI-related pages.github/workflows/deploy-docs.ymlto use--config-file mkdocs-v0.ymlduring v0 build and deploy stepsExample
The workflow now correctly builds each version:
When users select v0 from the dropdown, they see AnnoRank docs without XAI. Selecting v1 shows XAnnoRank docs with full XAI support.