Commit Graph

3 Commits

Author SHA1 Message Date
Tig
e9976da95e Reapply "Merge branch 'v2_develop' of tig:gui-cs/Terminal.Gui into v2_develop"
This reverts commit 845c05ff47.
2026-02-06 08:57:29 -07:00
Tig
845c05ff47 Revert "Merge branch 'v2_develop' of tig:gui-cs/Terminal.Gui into v2_develop"
This reverts commit 8c4030aed6, reversing
changes made to 280d6a5c1f.
2026-02-06 08:41:02 -07:00
Tig
d6eaabbde2 Add Vercel-style compressed documentation index to AGENTS.md (#4653)
* Add Vercel-style compressed documentation index to AGENTS.md

This replaces the previous summary-based approach with a retrieval-based
index following Vercel's agents.md pattern:

- Create .tg-docs/INDEX.md as detailed documentation index
- Add compressed pipe-delimited index directly in AGENTS.md
- Index points to source documentation files for on-demand retrieval
- Organize by category: Core Architecture, Layout, Commands, Input, etc.
- Include API namespace specs and source code directory structure
- Enable retrieval-led reasoning instead of embedding full content

The compressed format reduces token usage while preserving full
documentation access through file retrieval.

https://claude.ai/code/session_01PA5YNxogagLmiQrvvJNisX

* Add plan for comprehensive API docs compression

This plan outlines steps to:
1. Build docs with docfx to generate full API reference
2. Extract all types from generated metadata
3. Create Vercel-style compressed index with full API coverage
4. Include all ~270 classes, ~55 interfaces, ~55 enums

The plan enables continuation of this work in a CLI environment
where dotnet and docfx are available.

https://claude.ai/code/session_01PA5YNxogagLmiQrvvJNisX

* docs: add comprehensive API type index for AI agents

Add complete API reference with ~530 types across 12 namespaces:
- INDEX.md: Full detailed tables for all types by namespace
- AGENTS.md: Compressed pipe-delimited format for quick AI lookup
- Remove work-in-progress plan file

This completes the Vercel-style documentation compression effort,
providing AI agents with immediate access to API type information.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: add Vercel-style auto-generated file path index

Add Generate-SourceIndex.ps1 script that creates retrieval-led reasoning
indices for AI agents. Instead of embedding stale descriptions, the index
points to actual source files that agents read when needed.

- Create docfx/scripts/Generate-SourceIndex.ps1 to scan source and docs
- Update Build.ps1 to call generator before docfx build
- Rewrite .tg-docs/INDEX.md as auto-generated Vercel-style index
- Add injection markers to AGENTS.md for auto-updated source index
- Document the feature in docfx/README.md with link to Vercel blog post

Based on: https://vercel.com/blog/how-we-compressed-our-js-sdk-docs-by-80-percent-for-llms

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* regen

---------

Co-authored-by: Claude <noreply@anthropic.com>
2026-02-01 14:25:26 -07:00