Skip to content

Audit docs versus guides taxonomy #1122

Description

@luke-hagar-sp

Summary

Audit the developer site information architecture to distinguish official reference documentation from opinionated guides and getting-started content.

Context

The developer site update discussion identified confusion between docs, guides, generated API/reference material, and supplemental walkthroughs. The team agreed this is valuable but larger than the first site organization pass.

Scope

  • Review each top-level docs section for guide-like versus reference-like content.
  • Propose a clearer taxonomy for documentation, guides, and getting-started material.
  • Include transforms in the review, since transforms currently mix reference-like and guide-like content.
  • Identify redirects or sidebar changes needed for a future implementation.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions