Conversation
Replace the single Manual + API Reference toctree pair with six themed toctrees (Get started / File and storage / Servers and surfaces / Run-time controls / Composition / API reference) so every chapter is reachable from a clearly captioned sidebar group. Add an inline 'What it gives you' section that links each feature group to its chapter via :doc: references, and pull install / first action snippets above the toctrees so the homepage stands on its own. Mirror the structure across English, 繁體中文, and 简体中文.
|
Up to standards ✅🟢 Issues
|
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.
Summary
:doc:. Mirrored across English, 繁體中文, and 简体中文.ci-dev.yml/ci-stable.ymlmatrices.Commits in this PR
8dd5e42Slim docs landing page to a WebRunner-style intro5014eb8Add Python 3.13 and 3.14 to CI matrixecad849Rewrite docs homepage with feature-grouped toctreesTest plan
py -m sphinx -b html docs/source docs/_build/htmlpy -m sphinx -b html docs/source.zh-TW docs/_build/html-zh-TWpy -m sphinx -b html docs/source.zh-CN docs/_build/html-zh-CNConfirm zero new toctree / index warnings (only pre-existing autodoc duplicates remain).
index.htmland verify the six themed sidebar captions render and every chapter link resolves.Languages: …) cross-links the three builds correctly.ci-dev.yml/ci-stable.ymlruns go green on all five matrix entries (3.10 / 3.11 / 3.12 / 3.13 / 3.14).chore: bump version) still skips the bump-back commit, and the next manual merge to main triggers the version bump as expected.Notes
stable.toml/dev.toml(the publish workflow handles that on push to main).