Skip to content

Fix #496: Add "latest" alias to docs for stable URL sharing#503

Merged
albertohernandez1995 merged 5 commits intomainfrom
cr-496
Feb 13, 2026
Merged

Fix #496: Add "latest" alias to docs for stable URL sharing#503
albertohernandez1995 merged 5 commits intomainfrom
cr-496

Conversation

@javihern98
Copy link
Copy Markdown
Contributor

@javihern98 javihern98 commented Feb 12, 2026

Summary

  • Adds a /latest/ URL alias that always contains the latest stable release docs, so shared links like docs.vtlengine.meaningfuldata.eu/latest/walkthrough.html remain valid across releases
  • Root index.html now redirects to /latest/ instead of a specific version like /v1.4.0/
  • New generate_latest_alias.py script copies the latest stable version directory to _site/latest/ during the docs build

Test plan

  • Verify 16 new tests in tests/DocScripts/ pass (pytest tests/DocScripts/ -v)
  • Trigger docs workflow manually and confirm /latest/ directory is created in the deployed site
  • Confirm docs.vtlengine.meaningfuldata.eu/latest/ resolves correctly after deployment

Add a /latest/ URL that always points to the latest stable release,
so shared documentation links remain valid across releases.
rc10 was sorting lower than rc9 because the suffix was compared as a
string. Parse the pre-release number as an integer for correct ordering.
Rename the latest stable directory to latest/ and leave a redirect
at the old versioned path instead of duplicating the entire tree.
@javihern98
Copy link
Copy Markdown
Contributor Author

Confirmed it works as expected in Docs page. Click on other version, then back to the latest version and the URL redirection to latest now works successfully

@javihern98 javihern98 marked this pull request as ready for review February 12, 2026 17:47
@javihern98 javihern98 requested review from a team and albertohernandez1995 February 12, 2026 17:47
@javihern98 javihern98 linked an issue Feb 12, 2026 that may be closed by this pull request
Copy link
Copy Markdown
Contributor

@albertohernandez1995 albertohernandez1995 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good. Congrats!

@albertohernandez1995 albertohernandez1995 merged commit 8f64059 into main Feb 13, 2026
20 checks passed
@javihern98 javihern98 deleted the cr-496 branch February 13, 2026 11:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add page "latest" to docs pointing at latest release

2 participants