Skip to content

docs: add CONTRIBUTORS.md issues-only policy (closes #1517)#1604

Open
cliffhall wants to merge 4 commits into
v2/mainfrom
docs/1517-contributors-md
Open

docs: add CONTRIBUTORS.md issues-only policy (closes #1517)#1604
cliffhall wants to merge 4 commits into
v2/mainfrom
docs/1517-contributors-md

Conversation

@cliffhall

@cliffhall cliffhall commented Jul 2, 2026

Copy link
Copy Markdown
Member

Closes #1517

Adds CONTRIBUTORS.md (issues-only policy + version→board/branch/label table), the PR-template pointer, and an AGENTS.md ## Contributing link.

Provenance: this work was briefly folded into the Wave-1 rollup (1579-wave-1 / #1601) during review, then pulled back out — it's unrelated to the #1510 Apps-host decomposition that defines Wave 1. This PR is the real, standalone path to v2/main. Clean history (cherry-picked the doc commits onto v2/main, no rollup/merge/empty-commit noise). The old #1537 shows "merged into 1579-wave-1" from that interim step and is superseded by this.

cliffhall and others added 4 commits July 2, 2026 13:11
Document the contribution policy: we accept issues, not pull requests.
Maintainers handle design and implementation through a prompt-driven
workflow. Contributors who have already built a change locally should
share the prompt they used rather than a diff.

Cross-reference the policy from AGENTS.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…icy (#1517)

GitHub auto-populates pull_request_template.md into every new PR body,
so it steers would-be external PR authors to CONTRIBUTORS.md before they
submit a diff.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The policy takes effect after v2/main merges into main, leaving a single
line of development. Tell contributors to open a well-formed issue rather
than routing them to per-version project boards.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Completes requirement #2 of #1517: a table mapping each active version to
its base branch, project board, and version label, plus a "Label by
version" note mirroring AGENTS.md.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S3fTN8H3R8YV4yUGvZjYnX
@BobDickinson

Copy link
Copy Markdown
Contributor

I like this. I might remove the v1.5 references (and maybe kill the v1.5 branch altogether), since nobody outside of the core team probably ever saw that of knows what it is/was.

It might also be good to say that if you want to work on the project as part of the team, that we invite you to join us on Discord or attend our meetings. It seems like we need some way for someone who really is interested in volunteering either in general or in some specific area to be able to contribute under our supervision, with a possible path to becoming a maintainer. I'm not sure what that looks like, but I'm trying to make it seem like we've completely closed the door to people we really want to contribute a level that makes sense for us to support.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

v2 Issues and PRs for v2

Projects

None yet

2 participants