Skip to content

feat: add llms-txt generation#18

Open
centwright wants to merge 2 commits into
nodejs:mainfrom
centwright:codex/sourcey-llms
Open

feat: add llms-txt generation#18
centwright wants to merge 2 commits into
nodejs:mainfrom
centwright:codex/sourcey-llms

Conversation

@centwright

Copy link
Copy Markdown

Closes #10.

This adds a reproducible Sourcey-based generation step for the Undici documentation's LLM indexes:

  • pins sourcey@3.6.5 in the lockfile
  • generates out/llms.txt and out/llms-full.txt from the latest fetched Undici release docs
  • rewrites generated links to the canonical case-sensitive doc-kit routes
  • documents the build command and generated outputs

Validation performed:

  • npm ci
  • npm run build:fetch-docs
  • npm run build:html
  • npm run build:llms
  • live checks of six generated documentation URLs (all HTTP 200)
  • git diff --check

@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown

@centwright is attempting to deploy a commit to the OpenJS Foundation Team on Vercel.

A member of the Team first needs to authorize it.

@avivkeller avivkeller left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We have an LLM.txt generator in doc-kit

Comment thread sourcey.config.ts Outdated
@centwright
centwright force-pushed the codex/sourcey-llms branch from f1f7ea3 to 31dc494 Compare July 13, 2026 19:26
@centwright

Copy link
Copy Markdown
Author

Updated in 31dc494 to use doc-kit's existing llms-txt generator. The revision removes Sourcey and the custom generation script/config, adds llms-txt to the existing multi-version doc-kit invocation, and supplies a small Undici-specific template. I verified npm run build:html with a deployment-style VERCEL_URL and checked all 125 generated links across the current, v7, and v6 indexes against the generated HTML files.

@centwright

Copy link
Copy Markdown
Author

@avivkeller The requested change is addressed in 31dc494: this now uses doc-kit’s existing llms-txt generator and removes Sourcey plus the custom generator. Local multi-version build and generated-link validation both pass. GitHub does not allow this fork author to submit a formal re-review request, so could you re-review when convenient?

@vercel

vercel Bot commented Jul 13, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
undici-website Ready Ready Preview, Comment Jul 13, 2026 7:38pm

Request Review

@avivkeller avivkeller left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@AugustinMauroy AugustinMauroy left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@avivkeller avivkeller changed the title Generate llms.txt with Sourcey feat: add llms-txt generation Jul 13, 2026
@centwright

Copy link
Copy Markdown
Author

@AugustinMauroy Confirmed that both /v6.x/llms.txt and /v7.x/llms.txt returned 404 while neighboring versioned assets were served. Fixed in 8b18ac1 by generating byte-identical root-level mirrors and adding a constrained /vN.x/llms.txt rewrite. The full npm run build passes locally and all three mirrors match their generated indexes. Vercel requires OpenJS team authorization for this new fork commit; once the preview is authorized, I will verify the live v6 and v7 URLs.

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.

generate llms.txt ?

4 participants