Skip to content

Mark llms files as generated to hide from PR diffs#3058

Open
pwizla wants to merge 1 commit intomainfrom
repo/gitignore-llms-generated-files
Open

Mark llms files as generated to hide from PR diffs#3058
pwizla wants to merge 1 commit intomainfrom
repo/gitignore-llms-generated-files

Conversation

@pwizla
Copy link
Copy Markdown
Collaborator

@pwizla pwizla commented Apr 15, 2026

Summary

Adds a .gitattributes file that marks llms.txt, llms-full.txt, and llms-code.txt as linguist-generated=true. This tells GitHub to collapse these files in PR diffs by default.

Problem

Every PR that triggers a local build regenerates the llms files with slightly different output. This pollutes PR diffs with thousands of unrelated line changes, making reviews harder.

What this does

  • Adds .gitattributes with linguist-generated=true for the 3 llms files
  • GitHub will collapse these files in PR diffs (they can still be expanded manually)
  • The files stay in the repo — users and agents can still read them on GitHub
  • The CI job on main continues to update them when docs content changes
  • No changes to the build pipeline or Vercel deploy

What this does NOT do

  • Does NOT remove the files from git
  • Does NOT change the CI workflow
  • Does NOT affect the Vercel build

Local dev note

After running yarn build locally, these files get modified. Use git checkout -- docusaurus/static/llms*.txt before switching branches to avoid checkout conflicts.

@pwizla pwizla requested a review from derrickmehaffy as a code owner April 15, 2026 13:03
@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 15, 2026

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

Project Deployment Actions Updated (UTC)
documentation Ready Ready Preview, Comment Apr 15, 2026 1:14pm

Request Review

@github-actions github-actions Bot added internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo labels Apr 15, 2026
@pwizla
Copy link
Copy Markdown
Collaborator Author

pwizla commented Apr 15, 2026

Screenshot 2026-04-15 at 15 07 06 Note: We shoudn't be worried about these line counts 😂 It's only because the PR is removing llms*.txt files from the repo.

@pwizla pwizla force-pushed the repo/gitignore-llms-generated-files branch from 409a62f to f3ec5bc Compare April 15, 2026 13:12
@pwizla pwizla changed the title Stop tracking generated llms files, remove redundant CI job Mark llms files as generated to hide from PR diffs Apr 15, 2026
@pwizla pwizla self-assigned this Apr 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

internal PRs created by the Strapi core team pr: updated content PRs updating existing documentation content source: repo PRs/issues not targeting a specific documentation but rather affecting the whole repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant