Skip to content

Tidy up docs structure #9

@sanity

Description

@sanity

Near‑term structural tidy‑up

  • Remove duplication in dev / developer-guide

    • Move everything under resources/manual/developer-guide into /dev (or vice‑versa).
    • Delete the duplicate section after the move.
  • Adopt Diátaxis split

    • Under resources/manual create four top‑level buckets:
      get-started/, concepts/, how-to/, reference/.
    • Re‑file existing pages into the right bucket.
  • 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.

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

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions