docs: point repo links at the versioned /latest/ docs paths - #206
Merged
Merged
Conversation
- mike serves pages only under version directories; the root is a redirect - README /get-started/ was a 404, /tools/ served the superseded July build - CONTRIBUTING /dev/ resolved to mike's dev version, not the dev guide - root links in pyproject.toml and CITATION.cff stay unversioned
Contributor
Release previewNo version bump from the current commits (stays at Changelog preview (truncated)Preview via python-semantic-release and conventional commits. |
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.
Changes
README.mdline 26/get-started//latest/get-started/README.mdline 53/tools//latest/tools/README.mdline 60/get-started/#logging/latest/get-started/#loggingCONTRIBUTING.mdline 22/dev//latest/dev/Rationale
The documentation deploys with mike, which serves every page under a version
directory. The
gh-pagesroot holds only a redirect tolatest/. Unversioneddeep links therefore do not resolve to the intended page:
/get-started/returns 404./tools/returns 200, but serves the Sphinx page frozen at 2026-07-07. Adirectory from the pre-mike deployment still sits at the
gh-pagesroot. A200 here does not mean the link is correct.
/dev/returns 200, but serves mike'sdevversion home page, not thedevelopment guide. mike's version name
devcollides with the pagedocs/dev.md. The guide is at/latest/dev/.This became visible only after
#201 was fixed. The site
had been serving a 2026-07-07 build, so no documentation URL resolved
correctly.
Not changed
Links to the bare root stay unversioned, because
mike set-default --push latestwrites the root redirect:README.mdlines 4 and 16pyproject.tomlDocumentationCITATION.cffurlVerification
Every
opensemanticlab.github.io/osw-pythonURL remaining in the repositorywas fetched with curl. All five return 200. The
#logginganchor resolves to<h2 id="logging">Logging, the section describingOSW_LOG_LEVEL.Related
gh-pagesroot. Blocked until this PR merges, otherwise/tools/turns from stale content into a 404.