Improve directories layout: version subdirs and stable symlink#18
Merged
Improve directories layout: version subdirs and stable symlink#18
Conversation
Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/2341d4a3-e39f-4303-8eca-661070f1b5cc Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>
Copilot created this pull request from a session on behalf of
m-aciek
April 9, 2026 00:15
View session
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.
Summary
Improves the GitHub Pages published directory layout:
Per-version subdirectories: Format files are now stored under
_site/<major.minor>/(e.g._site/3.14/) instead of the flat_site/3/directory. Themajor.minoris obtained viapython -c 'from tools.extensions.patchlevel import get_version_info; print(get_version_info()[0])'in the Doc dir, which always returns justX.Y(unlikedist_versionwhich can returnX.Y.Zfor final releases).Stable symlink: In the scheduled deploy job, a relative symlink
3 -> <stable>(e.g.3 -> 3.14) is created, where the stable version is the first entry withstatus == "bugfix"from the release-cycle JSON.Changes
build.yamlmajor_minoroutput to thepreparejob alongside existingdist_versionpublishjob to place files in_site/${{ needs.prepare.outputs.major_minor }}/schedule.yamldeployjob "Copy archives" step to extractmajor_minorfrom each artifact filename usingsedand copy to the appropriate_site/<major_minor>/subdirectory_site/3 -> <bugfix_version>with error handling if no bugfix version is found