Skip to content

Doc: Restructure home page by domains of concern - #1028

Open
akcano wants to merge 3 commits into
mainfrom
docs/homepage
Open

Doc: Restructure home page by domains of concern#1028
akcano wants to merge 3 commits into
mainfrom
docs/homepage

Conversation

@akcano

@akcano akcano commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

Rebuilds the home page's "In this documentation" section around domains of concern, following the standard documentation home page structure.

@akcano
akcano requested a review from dmitry-lyfar September 8, 2026 19:59
@akcano akcano self-assigned this Sep 8, 2026
Document onboard-workshop alongside use-workshop and design-sdk, share
installation instructions, and update reference and SDK build links.
Add sphinx-structured-toc with support for section and external links,
heading-derived navigation names, and Markdown output. Keep upstream
rendering and ambiguity checks, with build-level regression coverage.
Separate workshop operation, configuration, SDK development, and maintenance
into subject domains with native structured-toc slices. Use full command
names and distinguish guides, concepts, and references.

Preserve destinations and heading aliases, add section labels for direct
links, and retain the Diataxis sidebar with category navigation disabled.
Keep external-link indicators, wrapping, and visible keyboard focus.
@akcano
akcano marked this pull request as ready for review September 11, 2026 08:14
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.

1 participant