Add post: Making RubyGems Guides friendly to humans and AI - #270
Merged
Conversation
Announces the sitemap, llms.txt, and raw Markdown routes merged in rubygems/guides on 2026-08-05. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Machine readable formats only pay off when the content behind them is current, so the post now covers the parallel content refresh. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The scorecard and Project DREAM were tacked on at the end. Motivation now opens the post and Project DREAM closes it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The post claimed documentation was where Project DREAM is easiest to see, but the announcement never mentions documentation. It does call for extending RubyGems infrastructure for emerging AI patterns, which is the pillar this work belongs under. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Also correct the llms-full.txt size to the measured 458 KB. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This post announces the three changes merged in rubygems/guides on 2026-08-05 that make guides.rubygems.org usable by AI agents. They are
sitemap.xmlandrobots.txt(rubygems/guides#523),llms.txtandllms-full.txt(rubygems/guides#525), and raw Markdown served by appending.mdto any guide URL (rubygems/guides#524).It also covers the content overhaul that ran alongside them, since a machine readable feed is only worth as much as the writing behind it, and it closes on Project DREAM as the wider context.
Generated with Claude Code