Skip to content

feat: add agent-readable docs support - #482

Open
taylor-fang wants to merge 3 commits into
mainfrom
feat/agent-readable-docs
Open

feat: add agent-readable docs support#482
taylor-fang wants to merge 3 commits into
mainfrom
feat/agent-readable-docs

Conversation

@taylor-fang

@taylor-fang taylor-fang commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Summary

  • document curated, exhaustive, scoped, and OpenAPI machine-readable entry points
  • validate generated machine routes and reject misspelled agent-discovery URLs
  • add non-JavaScript Mermaid source fallbacks to the content preview

Test plan

  • run all content validators and validator unit tests
  • run pnpm --filter ./apps/content test
  • run pnpm build:content

Rollout

Merge this PR before generaltranslation/gt-cloud#4499 so the live production rebuild consumes the updated source documentation.

Visual docs chrome changes are isolated in generaltranslation/gt-cloud#4536.

Taylor Fang added 3 commits August 24, 2026 18:14
Document the curated and scoped machine-readable routes, validate generated links, and keep preview rendering useful without JavaScript.
Mirror production spacing by separating second-and-later top-level sections without affecting subsections.
Keep the agent-readability PR focused by moving visual separators to the production UI change.
@taylor-fang
taylor-fang requested review from a team as code owners August 27, 2026 17:45
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