docs: restructure and improve documentation site

Closed
PP
8mo ago
+573645-39310

Summary

Major documentation restructuring for the Altimate Code docs site:

  • New nav structure: Getting Started (Overview + Quickstart) → Examples (Showcase + Guides) → Configure (unified section with Agents, Tools, Skills, Commands, Providers, Governance, Appearance, Integrations) → Interfaces (TUI, CLI, IDE, GitHub, GitLab) → Reference (What's New, Security FAQ, Network, Troubleshooting, Telemetry)
  • Merged Components + Configure into a single "Configure" section with a new overview page featuring architecture diagram and grid cards
  • Rewrote index.md with GTM messaging, hero section, feature cards, tool showcase, benchmarks, and quick demo prompts
  • Added LLM provider config to Quickstart page with /connect command and sample Anthropic config
  • Deduplicated content: removed duplicate example cards, trimmed warehouse/LLM config examples in Quickstart, consolidated permission docs with cross-references
  • Standardized terminology: "altimate" → "Altimate Code" in prose, consistent 55+ tool count across all pages, page titles matching nav labels
  • Added new pages: Configure overview (configure/index.md), What's New changelog (changelog.md)
  • Moved sections: Telemetry → Reference, Guides → Examples, Behavior → Governance
  • CSS improvements: site title highlight, install command no-wrap fix

Test plan

  • Run mkdocs serve and verify all pages render without errors
  • Check all internal links resolve correctly (no broken cross-references)
  • Verify nav structure matches expected hierarchy
  • Confirm "Altimate Code" appears correctly in header and browser tab
  • Review index.md landing page layout and formatting

🤖 Generated with Claude Code