Skip to content

docs: teach Workstation with an organized Docusaurus handbook - #1

Merged
DominicVonk merged 3 commits into
mainfrom
t3code/comprehensive-feature-docs
Sep 11, 2026
Merged

docs: teach Workstation with an organized Docusaurus handbook#1
DominicVonk merged 3 commits into
mainfrom
t3code/comprehensive-feature-docs

Conversation

@DominicVonk

@DominicVonk DominicVonk commented Sep 11, 2026

Copy link
Copy Markdown
Member

Publish an organized Docusaurus handbook at https://dovocode.github.io/workstation/ that teaches Workstation from first setup through daily operations and advanced integrations.

  • Add a six-section learning path, local full-text search, chapter navigation, responsive styling, and light/dark themes.
  • Explain reconciliation, pins, ownership, file policies, and the choice between resources, tasks, hooks, and health checks. Include a complete developer-workstation walkthrough and a runnable custom-tool tutorial.
  • Consolidate resource recipes and keep the generated TypeScript API under /api/. Redirect previously published guide/API URLs so existing bookmarks continue working.
  • Keep site dependencies in a private pnpm workspace and publish only static output through the existing guarded pnpm docs:publish command. Source pushes alone do not publish.

Validation: frozen dependency installation, pnpm check, package build, production docs build, and the full quality gate pass (337 tests; six optional container tests skipped). All 52 TypeScript examples type-check; the custom-tool lifecycle runs in an isolated temporary home; the developer configuration resolves on Linux/macOS. Checked generated HTML links/assets, local search data, edit links, and page/redirect coverage for all 117 previously published HTML URLs. No real workstation package/service mutations were performed during validation.

@DominicVonk DominicVonk changed the title docs: publish the Workstation handbook on GitHub Pages docs: teach Workstation with an organized Docusaurus handbook Sep 11, 2026
@DominicVonk
DominicVonk merged commit ba4bf75 into main Sep 11, 2026
6 checks passed
@DominicVonk
DominicVonk deleted the t3code/comprehensive-feature-docs branch September 11, 2026 22:18
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