-
Notifications
You must be signed in to change notification settings - Fork 8
Open
Description
Near‑term structural tidy‑up
-
Remove duplication in dev / developer-guide
- Move everything under
resources/manual/developer-guideinto/dev(or vice‑versa). - Delete the duplicate section after the move.
- Move everything under
-
Adopt Diátaxis split
- Under
resources/manualcreate four top‑level buckets:
get-started/,concepts/,how-to/,reference/. - Re‑file existing pages into the right bucket.
- Under
-
Replace repeated blurbs with links
- On the Platform page, trim the contract explanation to a short teaser and link to
concepts/contracts. - Audit other pages for duplicated text and replace with a link to the canonical doc.
- On the Platform page, trim the contract explanation to a short teaser and link to
Longer‑term polish
- Set up component‑level reuse so shared snippets (install commands, etc.) come from a single Markdown partial.
- Add audience filters (user, operator, developer) so readers can toggle views in the sidebar.
Metadata
Metadata
Assignees
Labels
No labels