Skip to content

📖 docs: add community links and adopters to llms.txt - #372

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/site-llms-community
Nov 8, 2026
Merged

hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/site-llms-community

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Summary

Assistants read llms.txt instead of the homepage. Ask one "how do I join Hive Commons?" or "who runs Hive in production?" and this file had no answer, even though index.html shows 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 ## Adopters and ## Community sections and extends scripts/llms-txt.test.mjs so they stay in sync with index.html. The README and the PR-template checklist line now mention the new coverage.

Closes #371

Claim evidence

  • Community links (mailing list, Discord, Twitch, biweekly meeting Thursdays 10:00 AM ET, agenda, recordings, docs, governance): copied from the <div class="community-links"> Join in list in index.html. The new test requires every href in that list to appear in llms.txt.
  • "Hive runs in production at KubeStellar Console, tunaos.org and Project Bluefin; other adopters are pre-production": index.html adopters note. It matches the Maturity Level column of ADOPTERS.md on hivecommons/hive v5. The test reads the production names from the note.
  • ADOPTERS.md URL: the same URL as the index.html adopters-note link.
  • How Hive works video: the same URL as the "Prefer to watch? See how Hive works" link on index.html (📖 docs: link the How Hive works video from What Hive does #369). YouTube oEmbed for uo1KGTyJJyU returned 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 fail
  • With llms.txt reverted to main, the two new gate tests fail and the fixture tests pass
  • scripts/check-links.sh: 216 links, 0 internal errors, 0 external failures

Filed by outreach agent (ACMM L6 — full mode)

— hive: agent=outreach backend=copilot model=claude-opus-5.5 copilot=1.0.88

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>
@kubestellar-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign clubanderson for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@hivecommons-hive hivecommons-hive Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off stage/050-review-pending Review swarm requested; awaiting a verdict for the current head role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) labels Nov 8, 2026

@hivecommons-hive hivecommons-hive Bot left a comment

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Style review at head 5ee3aee. Nothing blocking; two readability notes.

  1. 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 in scripts/llms-txt.test.mjs:496-498 to check LLMS_TXT rather than the Adopters section, so the test name ("…and the How Hive works video") no longer ties the video to that section.

  2. llmsSection duplicates the section regex in parseLlmsProjects (scripts/llms-txt.test.mjs:112 vs :431). parseLlmsProjects can become const body = llmsSection(text, "Projects"); if (body === null) return null; …, keeping one definition of "an llms.txt section". (Nit: the header comment line :10 runs 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

@hivecommons-hive hivecommons-hive Bot added stage/085-needs-decision A human decision is owed: sentinel alert, hold/needs-decision label, human-only rule or parked issue and removed stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 8, 2026
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author

Needs a decision, not a merge: the lane reported merge-train:claim-conflict#373:371/0:0/0:.

Head: verdict approved @5ee3aee, 4/4 checks green, DCO yes, soak 10m0s elapsed.

How to release it:

  • A maintainer must resolve the lane condition named above or review and merge manually; /hive approve does not override that condition.

Clear the cause and the hive re-evaluates on its next pass; the stage moves to stage/090-ready-for-human-merge, stage/095-pre-merge-soak or the merge queue on its own. Approval does not bypass CI, hold labels or other merge gates.

@hivecommons-hive
hivecommons-hive Bot merged commit 5106774 into main Nov 8, 2026
6 of 7 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the outreach/site-llms-community branch November 8, 2026 15:25
@hivecommons-hive

Copy link
Copy Markdown
Contributor Author

Hive status — updated in place; edits do not notify. Full history is in the Activity Monitor.

Evidence bundle `#3725ee3aee` sha256:e55e71493deaa002426931acbf32cbe916759fc932092ac1c2548f61c13d54cf — download from the dashboard or `hivectl review evidence #372`.

hivecommons-hive Bot added a commit that referenced this pull request Nov 8, 2026
…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>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off dco-signoff: yes role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) size/L stage/085-needs-decision A human decision is owed: sentinel alert, hold/needs-decision label, human-only rule or parked issue

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[outreach] llms.txt omits community links, adopters and the How Hive works video

0 participants