Summary
Current documentation is hosted at codectx.granth.tech (root) on an Astro/Starlight template that is outdated, poorly structured, and does not reflect the project's current state (v0.3.0). This issue tracks a full migration to Fumadocs hosted at codectx.granth.tech/docs, freeing the root for the new landing page.
Goals
- Migrate all existing content from Starlight to Fumadocs
- Restructure content to reflect the actual pipeline: dependency graph, tier ranking, budget-driven inclusion, AST summaries
- Make documentation both human-readable and AI-readable
- Replace template placeholder content with accurate, current information
- Free
codectx.granth.tech/ for the new landing page
Proposed Structure
/docs
├── Getting Started
│ ├── Installation
│ └── Quickstart
├── Concepts
│ ├── How codectx Works
│ ├── Dependency Graph and Context Ordering
│ ├── Tier Ranking
│ └── Budget-Driven File Inclusion
├── Reference
│ ├── CLI Reference
│ └── Configuration
└── Changelog
AI-Friendliness Requirements
- Add
llms.txt at root (codectx.granth.tech/llms.txt) following the llmstxt.org spec
- Add
llms-full.txt: single concatenated plain-text dump of all doc pages, generated at build time
- All content in MDX/Markdown, no JavaScript-gated rendering
- Structured headings on every page, no content buried in tabs
Technical Decisions
- Framework: Fumadocs (Next.js based)
- Search: Orama (client-side, works with static export)
- Deployment: Cloudflare Pages, routed under
/docs
- Content source: MDX files under
content/docs/
Routing Change
| Before |
After |
codectx.granth.tech |
codectx.granth.tech/docs |
codectx.granth.tech/installation |
codectx.granth.tech/docs/installation |
codectx.granth.tech/reference |
codectx.granth.tech/docs/reference |
Redirects from old URLs to new /docs/* equivalents must be configured
at the Cloudflare Pages level to avoid breaking existing links.
Acceptance Criteria
Out of Scope
- Landing page (tracked in separate issue)
- Versioned docs
- API reference auto-generation
References
Summary
Current documentation is hosted at
codectx.granth.tech(root) on an Astro/Starlight template that is outdated, poorly structured, and does not reflect the project's current state (v0.3.0). This issue tracks a full migration to Fumadocs hosted atcodectx.granth.tech/docs, freeing the root for the new landing page.Goals
codectx.granth.tech/for the new landing pageProposed Structure
AI-Friendliness Requirements
llms.txtat root (codectx.granth.tech/llms.txt) following the llmstxt.org specllms-full.txt: single concatenated plain-text dump of all doc pages, generated at build timeTechnical Decisions
/docscontent/docs/Routing Change
codectx.granth.techcodectx.granth.tech/docscodectx.granth.tech/installationcodectx.granth.tech/docs/installationcodectx.granth.tech/referencecodectx.granth.tech/docs/referenceRedirects from old URLs to new
/docs/*equivalents must be configuredat the Cloudflare Pages level to avoid breaking existing links.
Acceptance Criteria
/docsloads Fumadocs shell with working sidebar and searchllms.txtpresent atcodectx.granth.tech/llms.txtllms-full.txtgenerated at build time and accessible/docs/*pathsOut of Scope
References
codectx.granth.tech(root)