Structure
Page Archetypes
Most content fits better when you pick a “shape” and stick to it. These archetypes keep pages consistent and easy to scan.
Overview
Use for: defining a topic and pointing outward.
- Start with a short summary.
- Add key points and constraints.
- Link to deeper pages.
How-to
Use for: tasks and repeatable workflows.
- Prerequisites
- Steps
- Examples
- Troubleshooting/pitfalls
Reference
Use for: lists, tables, fields, and canonical details.
- Keep it structured.
- Minimize prose.
- Prefer tables where possible.
Checklist
Use for: quality gates and “did we remember to…”.
Glossary
Use for: short definitions and synonyms.
See also
Return to library home.