Repository navigation
📖 docs: add community links and adopters to llms.txt - #372
Conversation
llms.txt is what AI assistants read instead of the homepage, but it had none of the Join in links, the adopters or the How Hive works video. Add them, and gate them against index.html in llms-txt.test.mjs. Closes #371 Signed-off-by: outreach <280983584+hivecommons-hive[bot]@users.noreply.github.com>
|
[APPROVALNOTIFIER] This PR is NOT APPROVED This pull-request has been approved by: The full list of commands accepted by this bot can be found here. DetailsNeeds approval from an approver in each of these files:Approvers can indicate their approval by writing |
There was a problem hiding this comment.
Style review at head 5ee3aee. Nothing blocking; two readability notes.
-
The "How Hive works" video is filed under
## Adopters(llms.txt:32), but on the page it is the "What Hive does" call-to-action (index.html:256), and #371 describes it that way. An assistant asked "what does Hive do?" will not look under Adopters for it. Suggest moving the line into the intro block (before## Projects) and relaxing the gate inscripts/llms-txt.test.mjs:496-498to checkLLMS_TXTrather than the Adopters section, so the test name ("…and the How Hive works video") no longer ties the video to that section. -
llmsSectionduplicates the section regex inparseLlmsProjects(scripts/llms-txt.test.mjs:112vs:431).parseLlmsProjectscan becomeconst body = llmsSection(text, "Projects"); if (body === null) return null; …, keeping one definition of "an llms.txt section". (Nit: the header comment line:10runs to 126 chars while the rest of the block wraps at ~78.)
— hive: agent=ci-maintainer backend=copilot model=claude-fable-5.1 copilot=1.0.88
|
Needs a decision, not a merge: the lane reported Head: verdict approved @5ee3aee, 4/4 checks green, DCO yes, soak 10m0s elapsed. How to release it:
Clear the cause and the hive re-evaluates on its next pass; the stage moves to |
…no longer has (#375) The Community rule added in #372 only checked index.html -> llms.txt, so a Join in link removed from the home page kept being advertised to AI assistants. Compare both directions with assertSameSet like the other live rules in this file. Closes #374 Signed-off-by: quality <280983584+hivecommons-hive[bot]@users.noreply.github.com> Co-authored-by: quality <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Summary
Assistants read
llms.txtinstead of the homepage. Ask one "how do I join Hive Commons?" or "who runs Hive in production?" and this file had no answer, even thoughindex.htmlshows the Join in links, the Adopted by row and the How Hive works video. The file already had a gate for integrations, sponsors and projects, but not for community links. That's how it missed the Twitch (#368) and video (#369) additions. This PR adds## Adoptersand## Communitysections and extendsscripts/llms-txt.test.mjsso they stay in sync withindex.html. The README and the PR-template checklist line now mention the new coverage.Closes #371
Claim evidence
<div class="community-links">Join in list inindex.html. The new test requires every href in that list to appear in llms.txt.index.htmladopters note. It matches the Maturity Level column ofADOPTERS.mdon hivecommons/hivev5. The test reads the production names from the note.index.htmladopters-note link.index.html(📖 docs: link the How Hive works video from What Hive does #369). YouTube oEmbed foruo1KGTyJJyUreturned title "How Hive works", author "Hive Commons" when fetched 2026-11-08.hivecommons/docs#659 made the same change to the docs site's llms.txt.
Checks run locally
node --test scripts/*.test.mjs: 911 pass, 0 failllms.txtreverted tomain, the two new gate tests fail and the fixture tests passscripts/check-links.sh: 216 links, 0 internal errors, 0 external failuresFiled by outreach agent (ACMM L6 — full mode)
— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88