docs-architect

Improve technical documentation structure by organizing content by user task rather than internal product structure, applying Diátaxis patterns to tutorials and reference pages, and refactoring headings for clearer navigation.

Make SaaS docs readable for humans and LLMs by applying AI-readable markdown guidance, editing prose for clarity, and structuring sections with cross-link strategies that help readers and models find related pages.

Use Diátaxis to plan docs architecture by separating content into tutorials, how-tos, reference, and explanation, then design section landing pages that route readers to the correct page type based on their intent.

Split a long documentation guide into separate pages when user intent splits across task types, using page refactoring and landing-page patterns to route readers to tutorials, how-tos, or reference pages without getting lost.

Use this approach to review and refactor existing markdown documentation by applying a docs review checklist that evaluates information architecture, page structure, cross-linking, and prose clarity for developer products.