Skip to content

Improve LLM agent readability of the docs site - #42

Merged
aivascu merged 6 commits into
masterfrom
improve/llm-agent-docs
Sep 1, 2026
Merged

Improve LLM agent readability of the docs site#42
aivascu merged 6 commits into
masterfrom
improve/llm-agent-docs

Conversation

@aivascu

@aivascu aivascu commented Aug 31, 2026

Copy link
Copy Markdown
Member

Summary

  • Add /llms.txt and /robots.txt, plus build-time /sitemap.xml and /docs-markdown/** mirrors so agents can discover and fetch guide content as markdown.
  • Wire prepare-agent-assets into pregenerate, just, and CI; keep generated agent assets gitignored.
  • Preserve C# generics in API HTML and unescape DocFX \> / \(/\) so signatures read as Create<T>() in both HTML and /api-markdown.

Test plan

  • CI build passes (prepare-api + prepare-agent-assets + generate)
  • After deploy: /llms.txt, /robots.txt, /sitemap.xml return 200
  • /docs-markdown/get-started/introduction.md matches /docs/get-started/introduction
  • /api-markdown/autofixture/5-0-0-rc-1/autofixture.fixture.md has Build<T>() without backslashes
  • Fixture API HTML heading shows Build<T>() (not stripped / not T\>)

@aivascu
aivascu merged commit 3153b32 into master Sep 1, 2026
2 checks passed
@aivascu
aivascu deleted the improve/llm-agent-docs branch September 1, 2026 06:06
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant