Documentation Architecture
Primary structure
Use tree navigation as the primary model:
- Getting Started
- Core Concepts
- Features
- Integrations
- Troubleshooting
- FAQ
- Release Notes
Secondary discovery
Use tags as secondary discovery metadata, not as primary navigation.
Localization structure
Use mirrored locale trees:
docs/en/...docs/nl/...
Keep the same relative path for equivalent pages.
Versioning strategy
Start with latest-only docs. Add version snapshots after release complexity justifies the extra maintenance.
