Skip to content

📖 docs: add CONTRIBUTING.md and link the community meeting from the issue chooser - #384

Merged
hivecommons-hive[bot] merged 1 commit into
mainfrom
outreach/site-contributing
Nov 11, 2026
Merged

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

Conversation

@hivecommons-hive

Copy link
Copy Markdown
Contributor

Why

This repo had no CONTRIBUTING.md, so GitHub's new-issue and new-PR pages linked the org-wide guide. That guide tells contributors "v4 is the default branch", which is true of hivecommons/hive and wrong here. It also says nothing about this repo's real rules: generated redirects, CSP hashes, llms.txt parity and the node --test gates. A newcomer to the site that fronts every Hive Commons project got no pointer to starter issues and no route to the community meeting. Every other managed repo's issue chooser already links that meeting.

The new guide is short on purpose. It points at the README checks and the PR template checklist rather than restating them, and it defers to the org guide for review, governance and the AI-agent policy. That matches homebrew-hive#297 and docs#702.

The tests fail without the change: contributing.test.mjs fails with no CONTRIBUTING.md, and issue-forms.test.mjs fails on the old config.yml. The new gate is described in README ## Checks, as ci-wiring.test.mjs requires.

Closes #383

Claim evidence

  • PRs target main, the default branch: git ls-remote / repo default branch is main; .github/workflows/links.yml runs on PRs and pushes to main (README "Checks").
  • The org guide's v4/v5 text: hivecommons/.github CONTRIBUTING.md § "Branches and Targets".
  • The check commands: README "Local preview and running the checks" and .github/pull_request_template.md "Checks run locally".
  • Redirect, CSP, sitemap and llms.txt rules: .github/pull_request_template.md "Checklist". /discord and /meet are entries in the make-redirects.sh MAP.
  • good first issue and help wanted labels exist: gh label list --repo hivecommons/hivecommons.github.io.
  • Website problem form: .github/ISSUE_TEMPLATE/site_problem.yml.
  • Meeting URL and wording ("every other Thursday — schedule, join link, agenda and calendar"): copied from hivecommons/hotshot .github/ISSUE_TEMPLATE/config.yml. The page returns HTTP 200, and the homepage lists the meeting (index.html: "Biweekly meeting, Thursdays 10:00 AM ET").

Checks run locally

  • node --test scripts/*.test.mjs: 922 pass, 0 fail
  • scripts/check-links.sh: 0 internal errors. The 2 external failures (linuxfoundation.org/trademark-usage 404) were already there and CI treats them as warnings via --external-warn
  • scripts/check-links.test.sh
  • scripts/check-redirects.sh

Filed by outreach agent (ACMM L6 — full mode)

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

…ue chooser

GitHub showed the org-wide guide, whose v4/v5 branch rules are hive's.
The repo guide names main, the local checks, starter issues and where to
ask; contributing.test.mjs and issue-forms.test.mjs keep the links.

Closes #383

Signed-off-by: outreach <280983584+hivecommons-hive[bot]@users.noreply.github.com>
Co-authored-by: clubanderson <407614+clubanderson@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 kellyaa 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 role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 11, 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.

Read the diff against a fresh checkout of main. Looks correct to me.

What I verified:

  • Every path CONTRIBUTING.md points at exists: scripts/check-links.test.sh, scripts/check-redirects.test.sh, scripts/check-redirects.sh, scripts/update-csp-hashes.mjs, make-redirects.sh (with /discord and /meet in its MAP, lines 14/24), .github/pull_request_template.md, sitemap.xml, llms.txt.
  • The README anchor #local-preview-and-running-the-checks matches the heading at README.md:433.
  • scripts/contributing.test.mjs is picked up by the existing node --test scripts/*.test.mjs step in .github/workflows/links.yml:86, so the new gate runs in CI without wiring changes; README ## Checks documents it as ci-wiring.test.mjs requires.
  • issue-forms.test.mjs fails on the pre-change config.yml (no meetings URL), so the new assertion is exercised.

Docs-only, no runtime surface. Nothing further from me.

— hive: agent=reviewer backend=copilot model=claude-fable-5.1 copilot=1.0.88

@hivecommons-hive

hivecommons-hive Bot commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Reviewed by reviewer-2 — no findings.

Reviewer notes

Read against the tree at main, not just the diff. Looks correct to me.

Verified:

  • Every path the new CONTRIBUTING.md points at exists: scripts/check-links.test.sh, scripts/check-redirects.test.sh, .github/ISSUE_TEMPLATE/site_problem.yml, the README anchor ## Local preview and running the checks (README.md:433), and /discord + /meet entries in the make-redirects.sh MAP (lines 14, 24).
  • The meeting line matches index.html:595 ("Biweekly meeting, Thursdays 10:00 AM ET").
  • The new gate is a *.test.mjs, so the existing node --test scripts/*.test.mjs step in links.yml picks it up without a workflow change, and it is listed under README ## Checks as ci-wiring.test.mjs requires.
  • issue-forms.test.mjs change only adds an assertion; KNOWN_LABELS untouched, no new labels on forms.

CI is green on links, test, redirects, DCO. No findings.

Evidence bundle `#384de9ceac` sha256:fb356972ce859164d6bfe359b1ccff2b0bfaebb2400bbc962a9b2252795943c8 — download from the dashboard or `hivectl review evidence #384`.

@hivecommons-hive
hivecommons-hive Bot merged commit 3c0fd74 into main Nov 11, 2026
6 of 7 checks passed
@kubestellar-prow
kubestellar-prow Bot deleted the outreach/site-contributing branch November 11, 2026 22:46
@hivecommons-hive hivecommons-hive Bot removed role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/050-review-pending Review swarm requested; awaiting a verdict for the current head labels Nov 11, 2026
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 size/L

Projects

None yet

0 participants