Skip to content

feat: Add links to other llms-full files to /docs/llms-full.txt#3333

Open
royanger wants to merge 10 commits into
mainfrom
roy/add-llms-filter
Open

feat: Add links to other llms-full files to /docs/llms-full.txt#3333
royanger wants to merge 10 commits into
mainfrom
roy/add-llms-filter

Conversation

@royanger
Copy link
Copy Markdown
Member

@royanger royanger commented Apr 30, 2026

🔎 Previews:

  • n/a

What does this solve? What changed?

  • Prepends a descriptive header to the generated llms-full.txt, including a brief description and links to companion llms-full.txt files (top-level index, articles, blog, changelog).
  • Exports LLMS_FULL_HEADER from scripts/lib/llms.ts and updates the build test to use it.
  • Adds a missing description to docs/guides/development/deployment/staging-alternatives.mdx.

Adds the following to the top of /docs/llms-full.txt

## Companion files

- [All sections index](https://clerk.com/llms-full.txt): Top-level index linking to every llms-full.txt file on clerk.com
- [Articles](https://clerk.com/articles/llms-full.txt): Full content of all Clerk articles
- [Blog](https://clerk.com/blog/llms-full.txt): Full content of all Clerk blog posts
- [Changelog](https://clerk.com/changelog/llms-full.txt): Full content of all Clerk changelog entries

---

Deadline

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 30, 2026

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

Project Deployment Actions Updated (UTC)
clerk-docs Ready Ready Preview May 13, 2026 4:17pm

Request Review

@royanger royanger marked this pull request as ready for review April 30, 2026 00:55
@royanger royanger requested a review from a team as a code owner April 30, 2026 00:55
@royanger royanger changed the title feat: Add filtering for root llms.txt feat: Add links to other llms-full files to /docs/llms-full.txt May 8, 2026
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@manovotny
Copy link
Copy Markdown
Contributor

Pushed a small test fix directly in 9dcc12d.

  • Inlined the expected llms-full.txt header text in scripts/build-docs.test.ts instead of interpolating ${LLMS_FULL_HEADER}. The previous form would still pass if the header URLs or wording were silently changed in scripts/lib/llms.ts; the inlined version now fails loudly on any unintended edit.

Copy link
Copy Markdown
Contributor

@manovotny manovotny left a comment

Choose a reason for hiding this comment

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

Approving, but I did add the do not merge label because https://github.com/clerk/clerk/pull/2507 needs to be merged first, otherwise the companion links will fail/404.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants