Skip to content

docs: point llms.txt links at unified Mozilla.ai files - #957

Merged
njbrake merged 2 commits into
mainfrom
fix/931-llms-txt
Sep 21, 2026
Merged

njbrake merged 2 commits into
mainfrom
fix/931-llms-txt

Conversation

@njbrake

@njbrake njbrake commented Sep 21, 2026

Copy link
Copy Markdown
Contributor

Description

The docs homepage offered two links for people and tools that want the documentation in a machine-readable form. Both of those links were dead and returned a "not found" error, because the files they pointed at disappeared when the documentation moved over to GitBook. Mozilla.ai now publishes one combined set of those files covering all of its projects, so the links now point there instead. Anyone following them gets a working page again.

Swaps the per-repo docs.mozilla.ai/any-agent/llms.txt and llms-full.txt links in docs/index.md for the org-level docs.mozilla.ai/llms.txt and llms-full.txt. Same fix as mozilla-ai/any-llm#1048.

Only docs/index.md referenced the dead URLs; no other docs, workflow, or script did.

PR Type

  • Documentation

Relevant issues

Fixes #931

Checklist

  • I understand the code I am submitting.
  • I have added unit tests that prove my fix/feature works
  • I have run this code locally and verified it fixes the issue.
  • New and existing tests pass locally
  • Documentation was updated where necessary
  • I have read and followed the contribution guidelines
  • AI Usage:
    • No AI was used.
    • AI was used for drafting/refactoring.
    • This is fully AI-generated.

No unit test: the change is two URLs in a Markdown file. Verification was curl against every URL left in the touched file, all 200.

AI Usage Information

  • AI Model used: Claude Opus 5 (1M context)

  • AI Developer Tool used: Claude Code

  • Any other info you'd like to share: Investigation and the decision to point at the org-level files were @njbrake's; the edit and the prose here are the model's.

  • I am an AI Agent filling out this form (check box if true)

🤖 Generated with Claude Code

The per-repo https://docs.mozilla.ai/any-agent/llms.txt and llms-full.txt
stopped existing when the docs moved to GitBook, so both returned 404.
Point at the org-level https://docs.mozilla.ai/llms.txt and llms-full.txt
instead, matching the fix applied in any-llm (mozilla-ai/any-llm#1048).

Fixes #931

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@codecov

codecov Bot commented Sep 21, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
see 90 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@njbrake
njbrake marked this pull request as ready for review September 21, 2026 16:46
GitBook paginates llms-full.txt: page 0 and page 1 hold other
Mozilla.ai projects, and the any-agent docs only start on page 2.
Calling it "complete documentation concatenated into a single file"
was wrong in both halves and failed silently, since the link returns
200 with no any-agent content in it. Say that it is paginated, and
note that llms.txt carries an any-agent section linking every page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@njbrake
njbrake merged commit a469723 into main Sep 21, 2026
3 checks passed
@njbrake
njbrake deleted the fix/931-llms-txt branch September 21, 2026 16:55
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.

llms.txt and llms-full.txt is broken

1 participant