Creating Documentation Sites
Learn how to build a documentation site with sidebar navigation using Cravo.
Overview
Cravo is perfect for creating documentation sites, knowledge bases, and help centers. The Docs template provides:
- Sidebar navigation for easy browsing
- Hierarchical structure for organized content
- Breadcrumbs for location awareness
- Fast, searchable content
Choosing a Docs Template
When creating a new site:
- Click Create New Site in your dashboard
- Select Start with a Template
- Choose the Documentation template
- Connect your Craft document
📸 PLACEHOLDER: Screenshot
Template selection showing the Documentation template.
Documentation Structure
Organize your Craft document for optimal documentation:
text
1Docs (Root)2├── Getting Started3│ ├── Installation4│ ├── Quick Start5│ └── Configuration6├── Guides7│ ├── Basic Usage8│ └── Advanced Topics9└── API Reference10 ├── Authentication11 └── Endpoints
Structure Best Practices
- Top-level = Sections – Major categories
- Second-level = Topics – Individual articles
- Third-level = Details – Sub-articles if needed
Enabling Side Menu
For documentation sites, enable the Side Menu:
- Go to Content → Menus
- Enable Side Menu
- Configure sidebar settings
- Save changes
The sidebar automatically generates from your page hierarchy.
📸 PLACEHOLDER: Screenshot
A docs site showing the sidebar with expandable sections.
Recommended Settings
For the best documentation experience:
| Setting | Recommendation |
|---|---|
| Top Menu | ✅ ON – For main sections |
| Side Menu | ✅ ON – For navigation |
| Breadcrumbs | ✅ ON – For location |
| Wide View | ❌ OFF – Better readability |
Writing Good Documentation
- Clear headings – Use consistent heading levels (H2, H3)
- Code blocks – Use fenced code blocks for examples
- Callouts – Use Craft callouts for tips and warnings
- Short paragraphs – Easy to scan
- Visual aids – Include screenshots and diagrams
What's Next?
- Adding Breadcrumbs – Configure breadcrumb navigation
- Working with Craft Blocks – Supported block types
Need help? Contact us at support@cravo.life