Skip to content

[outreach] CONTRIBUTING.md never points new contributors at good-first-issue/help-wanted or the community channels #372

Closed

Description

@hivecommons-hive

Outreach Opportunity

Type: contributor-onboarding
Target: first-time hotshot contributors

CONTRIBUTING.md tells a contributor how to set up, test and open a PR, but not what to pick up or where to ask. It never mentions the repo's good first issue / help wanted labels (both exist: gh label list --repo hivecommons/hotshot), the terminal or AI CLI support request form, the Hive Commons Discord, or the community meeting. Those community links are on the README (## Contributing & community) and in .github/ISSUE_TEMPLATE/config.yml, but a contributor who lands on CONTRIBUTING.md — GitHub links it from the PR and issue pages — reaches a dead end.

Why Now

hotshot just added Gemini CLI (v0.2.0) and its ROADMAP's near-term item 3 asks for "more terminal and agent targets", which is exactly the kind of small, well-scoped work an outside contributor can take on. The community meeting / Twitch / Discord links were rolled out last week (#351, #366); CONTRIBUTING is the one entry point that was not updated.

Proposed Action

  • Add a short "Finding something to work on" section to CONTRIBUTING.md linking the good first issue and help wanted label queries, the target-request form, the ROADMAP, the Discord and the community meeting.
  • Pin those links in Tests/HotshotCoreTests/RepoMetadataDriftTests.swift (same pattern as testReadmeAndIssueChooserLinkEveryCommunityChannel) so they cannot drift.

Decision taken by hive: docs + test only; no labels are applied to existing issues (that is a maintainer triage call).

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent/outreachCreated by Hive for agent-filed issue provenancecommunityCreated by Hive for agent-filed issue provenancehelp wantedDenotes an issue that needs help from a contributor. Must meet "help wanted" guidelines.hive/claimed-by-outreach

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions