Repository navigation
Conversation
tony
force-pushed
the
sphinx-inventories
branch
9 times, most recently
from
October 19, 2026 00:19
a1c7119 to
bdc2ede
Compare
why: Sphinx consumers need discoverable port references, and the root publisher needs a catalog for the selected default version. what: - Adopt scoped inventories, catalogs and footer discovery - Adopt the reference fixes and generic links from docs PR 157 - Use the shared publisher's locked uv, Ruff and ty tooling - Restrict scoped inventory to the actual port/version mount - Place inventory setup help under the site meta section - Declare the three-day uv cooldown for portable locked installs - Make the Python CLI checks executable for Linux Ruff - Keep decorative kind marks out of row and inventory names - Resolve command options under native Sphinx program contexts - Keep both docs workflow pins on the same revision validation: YAML, callee bindings, paired pins and minimal diffs pass. The combined docs branch passes 221 site and 23 Swift model checks, Ruff, formatting, ty and TypeScript checks; 23 assembled-tree contracts were skipped. Complete publication evidence remains a separate gate. Docs source: libtmux/docs@205ecac
tony
force-pushed
the
sphinx-inventories
branch
from
October 20, 2026 00:43
bdc2ede to
f7c5971
Compare
This branch has not been deployed
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
1 participant
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.
Sphinx projects need discoverable references to the Java, Kotlin and Scala documentation on libtmux.org. Pin the docs build and publisher to the rebased inventory producer from libtmux/docs#166. Built versions gain
objects.inv,targets.json, footer downloads and Sphinx setup help. Root publication composesobjects-full.invfrom selected default catalogs.The producer is rebased onto docs
mainand retains #157's exact head. It includes durable target identities, migration aliases, canonical Sphinx option aliases and uv-managed Python tooling with Ruff and ty.Validation
48a11adb39ac2b6a2bb9e451bc8ba54679679be2. Only.github/workflows/docs.ymlchanges, with both producer refs set to the same commit. All non-pin content is preserved.Keep this PR as a draft for review. Update both refs to the landed docs commit before merging, and publish every selected default catalog, including Python stable, before canonical root composition. Newly triggered CI and live publication remain separate from the local checks above.