Skip to content

feat(llms-txt): generate llms.txt and per-page markdown at build time - #4743

Merged
ShaneK merged 6 commits into
mainfrom
FW-7589
Sep 23, 2026
Merged

ShaneK merged 6 commits into
mainfrom
FW-7589

Conversation

@ShaneK

@ShaneK ShaneK commented Sep 18, 2026 •

Copy link
Copy Markdown
Member

Issue URL: internal

What is the current behavior?

Currently, an agent reading the docs parses rendered HTML, which on a component page means digging prop tables out of <table> markup and missing the playground examples entirely, since those mount on the client. This isn't ideal and can make it more difficult than necessary for LLMs to understand how to use Ionic Framework components.

What is the new behavior?

A new postBuild plugin writes /docs/llms.txt in the llmstxt.org format, 305 links grouped by the current version's sidebar categories, with api, cli and native under the spec's ## Optional heading. It also writes 608 markdown twins, one per sidebar-reachable page in both built versions, so /docs/api/button is also readable at /docs/api/button.md, which helps LLMs parse and understand things easier than HTML.

Additionally, we added an alternate link to doc pages that links to the md pages, helping with discoverability.

Does this introduce a breaking change?

  • Yes
  • No

Other information

@ShaneK
ShaneK requested a review from a team as a code owner September 18, 2026 19:01
@vercel

vercel Bot commented Sep 18, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
ionic-docs Ready Ready Preview Sep 23, 2026 5:57pm UTC

Request Review

@ShaneK ShaneK changed the title feat(llms-txt): generate llms.txt and per-page markdown twins at buil… feat(llms-txt): generate llms.txt and per-page markdown at build time Sep 18, 2026

@thetaPC thetaPC left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, left some non-blocking requests/questions.

Comment thread vercel.json
Comment thread plugins/docusaurus-plugin-llms-txt/README.md
Comment thread plugins/docusaurus-plugin-llms-txt/README.md Outdated
Comment thread src/theme/DocItem/Layout/index.tsx Outdated
Comment thread plugins/docusaurus-plugin-llms-txt/README.md

@thetaPC thetaPC left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, left one suggestion

@ShaneK
ShaneK enabled auto-merge (squash) September 23, 2026 17:56
@ShaneK
ShaneK merged commit 472ca32 into main Sep 23, 2026
7 checks passed
@ShaneK
ShaneK deleted the FW-7589 branch September 23, 2026 17:58

This branch was successfully deployed

1 active deployment
Preview — 64a65c18 Deployed Sep 23, 2026 by vercel[bot]
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.

2 participants