Skip to content

[outreach] No CONTRIBUTING.md: GitHub shows the org guide's v4/v5 branch rules; newcomers get no starter issues, and the issue chooser lacks the community meeting #383

Closed

Description

@hivecommons-hive

Outreach Opportunity

Type: contributor-onboarding
Target: first-time contributors to hivecommons/hivecommons.github.io (hivecommons.dev)

This repo has no CONTRIBUTING.md, so GitHub links the org-wide fallback (hivecommons/.github/CONTRIBUTING.md) from the new-issue and new-PR pages. That file is written for hivecommons/hive. It says "v4 is the default branch" and "v5 is the next-generation line", but this repo has only main. It never mentions this repo's own rules: the local checks (node --test scripts/*.test.mjs and the shell gates), generated shortcut redirects (make-redirects.sh), CSP hash refresh and llms.txt/sitemap.xml parity. Those rules are in README.md (Contributing section, and "Local preview and running the checks") and .github/pull_request_template.md.

A newcomer also gets no pointer to what to work on or where to ask:

  • good first issue and help wanted labels exist in this repo, but nothing links them
  • the Website problem form (.github/ISSUE_TEMPLATE/site_problem.yml) is not linked
  • the issue chooser (.github/ISSUE_TEMPLATE/config.yml) links Discord and Twitch but not the community meeting. The homepage lists it (index.html: "Biweekly meeting, Thursdays 10:00 AM ET"), and so do llms.txt and the chooser of every other managed repo (e.g. hivecommons/hotshot config.yml → https://docs.hivecommons.dev/docs/community/meetings)

Why Now

homebrew-hive (hivecommons/homebrew-hive#297) closed the same org-fallback gap, and hotshot (#372), promptargs (#469), dibs (#641) and docs (#702) closed the same starter-issue gap. hivecommons.dev is the front door for every Hive Commons project, and it's the last managed repo in that pass apart from crux. crux waits on its branch cutover.

Proposed Action

  • Add CONTRIBUTING.md: PRs target main; the org file's v4/v5 rules don't apply here; point at the README checks and the PR template checklist; DCO sign-off; starter labels, Website problem form, Discord and community meeting; defer to the org guide for review/governance/AI-agent policy
  • Add a "Join the community meeting" contact link to .github/ISSUE_TEMPLATE/config.yml
  • Extend scripts/issue-forms.test.mjs to require the meeting link, and add a zero-dependency node --test gate that fails if CONTRIBUTING.md loses those links (described in README ## Checks, as ci-wiring.test.mjs requires)

Decision taken by hive: docs plus a test only, mirroring homebrew-hive/hotshot/docs. The meeting link uses the docs meetings page (schedule, join link, agenda, calendar), the same one the other repos use. No labels are applied to existing issues; that's left to maintainer triage.


Filed by outreach agent (ACMM L6 — full mode)

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

Activity

  1. hivecommons-hive commented on Nov 11, 2026

    @hivecommons-hive
    ContributorAuthor

    🔒 Claimed by agent outreach (agent on hive hosted-available-oke-11-placeholder-r05x). The claim lasts 2h0m0s without activity and renews while the work continues. Reply /unclaim to release, or /claim to take it over if you outrank the holder.

    Claim history
    • 2026-11-11 22:20 UTC — claimed by outreach (agent on hive hosted-available-oke-11-placeholder-r05x)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/outreachCreated by Hive for agent-filed issue provenancecommunityCreated by Hive for agent-filed issue provenance

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions