docs: sync from help-docs (source of truth)

Merged
SA
3mo ago
+3811-853

Initial docs sync from AltimateAI/help-docs, which is now the source of truth for documentation.

  • Content-only mirror generated by help-docs tools/sync_to_oss.py.
  • Edit docs in help-docs, not here β€” each file carries a do-not-edit banner; this copy is regenerated automatically.
  • Non-destructive: repo-only files (CNAME, overrides/, css, requirements, and any repo-only pages) are preserved, not deleted.
  • Unified-site links de-prefixed; mkdocs.yml nav regenerated from help-docs.

First sync is large because help-docs content was developed substantially post-migration. Please review; anything here that should live in help-docs instead can be pulled back before merge.

πŸ€– Generated with Claude Code


Summary by cubic

Syncs docs from AltimateAI/help-docs and refreshes homepage/nav/styles. Consolidates Quickstart (Setup folded in) and removes the orphaned top-level /quickstart/ page; all Quickstart links now point to getting-started/quickstart/.

  • Migration

    • Source of truth is AltimateAI/help-docs; this repo mirrors via help-docs/tools/sync_to_oss.py (prunes orphans, preserves repo-only assets).
    • Deleted docs/docs/quickstart.md to eliminate route drift; update any remaining links to getting-started/quickstart/ (external /quickstart/ relies on help-docs 301).
    • IA updates: removed getting-started/quickstart-new.md; Quickstart is a single canonical page; moved CI guide to usage/ci-headless.md; mkdocs.yml nav regenerated.
    • Links canonicalized to help.altimate.ai where appropriate; docs/docs/llms.txt regenerated with updated date and canonical source.
  • Review focus

    • Added brand styles and assets: assets/stylesheets/{extra.css,neoteroi-cards.css,copy-page.css} and assets/brand/logo-white.svg; wired via extra_css with a β€œCopy page” control.
    • Front matter titles/descriptions added across pages; homepage replaced with a real landing page.
    • Privacy/telemetry docs clarify CLI browser-auth identifiers and retention.
    • IDE docs reflect β€œAltimate MCP” naming; permissions/keybinds remove the in-TUI Ctrl+Y yolo toggle.

Summary by CodeRabbit

  • Documentation
    • Added titles and descriptions across configuration, usage, reference, development, and data engineering pages to improve navigation and search.
    • Reworked navigation with Overview, integrations, tools, examples, and FAQ content.
    • Replaced the documentation home redirect with a branded Altimate Code landing page featuring product highlights, benchmarks, and quick links.
    • Rewrote the Quickstart, added a comprehensive setup guide, and updated links, branding, integrations, and telemetry guidance.
  • Style
    • Added responsive themes, cards, homepage layouts, navigation enhancements, and a themed Copy page control.