docs(contributing): trim to goose-scale minimal intake surface#2780
Merged
Conversation
Add a PR template, restructure CONTRIBUTING.md with a 'Before You Open a PR' section, and replace the placeholder issue templates with GitHub issue forms. Changes: - New .github/PULL_REQUEST_TEMPLATE.md: duplicate-check field (fill-in closest existing PR/issue number), issue link, just-ci gate, one logical change reminder, and AI/agent disclosure checkbox. - CONTRIBUTING.md: add 'Before You Open a PR' section at the top covering duplicate-check policy, duplicate-triage policy, issue-first rule for features, agent-contribution policy, and PR title convention. Fix intro to point to issues (Discussions are disabled on block/buzz). Drop the now-redundant 'Before You Start' bullets from the PR section. Drop dangling ToC entry for MCP tool guide (section was never written). - .github/ISSUE_TEMPLATE/bug-report.yml: replace placeholder markdown template with a GitHub issue form; required fields for repro steps, expected/actual behavior, OS, Buzz version, and logs. - .github/ISSUE_TEMPLATE/feature-request.yml: new form with required duplicate-search field, problem statement, and proposed solution. - .github/ISSUE_TEMPLATE/config.yml: blank_issues_enabled: false; remove placeholder Discord contact link. Co-authored-by: Will Pfleger <pfleger.will@gmail.com> Signed-off-by: Will Pfleger <pfleger.will@gmail.com>
wpfleger96
marked this pull request as draft
July 24, 2026 23:02
Apply review feedback from pass 1: - Rewrite 'Before You Open a PR' to lead with contributor benefit (two-minute search saves duplicate work) rather than closure stats; drop the hard four-step permission gate and 'Duplicate-check in your PR template' subsection; soften agent-policy to 'may be closed with a pointer'; issue-first is now a strong recommendation, not a gate - Fix intro to route questions to the new question.yml form instead of a dead 'community channels' link - Restore 'How to Add a New MCP Tool' ToC entry (#2612 owns the section body; this restores the pre-existing entry) - Replace 'within a few business days' review SLA with capacity-honest language - PR template: issue-first wording → recommendation; replace conditional AI checkbox with explicit fill-in field; add conditional integration test item (just ci does not run just test); fix '#' prefix on duplicate field; fix bare 'Fixes #' line - bug-report.yml: point version field to Desktop Settings footer; drop buzz --version (flag does not exist); allow 'unknown' - feature-request.yml: issue-first wording → recommendation - Add question.yml issue form with two required fields (what/tried) and optional environment; links question route end-to-end Co-authored-by: Will Pfleger <pfleger.will@gmail.com> Signed-off-by: Will Pfleger <pfleger.will@gmail.com>
…s ref - PULL_REQUEST_TEMPLATE.md: rewrite Related issue comment to say opening an issue is 'strongly recommended' (not required); remove the now-duplicate old line - CONTRIBUTING.md: remove 'or reach out in the community channels' from intro (no channel to link; question form is the route) Co-authored-by: Will Pfleger <pfleger.will@gmail.com> Signed-off-by: Will Pfleger <pfleger.will@gmail.com>
Replace 5-file, ~180-line template surface with a 4-file, ~50-line goose-modeled set: - PR template: drop checklist and AI-disclosure field; keep Summary, Related issue (with duplicate-check prompt), Testing - Issue templates: replace YAML forms with plain-markdown bug-report.md and feature-request.md; duplicate-check guidance lives in both the feature template footer and the PR template comment - config.yml: blank_issues_enabled: true (question form removed; questions route to blank issues) - CONTRIBUTING: compress 'Before You Open a PR' to four prose sentences covering duplicate search, issue-first recommendation, AI ownership, and review cadence; update intro link to plain /issues/new Co-authored-by: Will Pfleger <pfleger.will@gmail.com> Signed-off-by: Will Pfleger <pfleger.will@gmail.com>
wpfleger96
changed the title
wpfleger96
marked this pull request as ready for review
July 25, 2026 16:02
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replace the 5-file, ~180-line template surface with a 4-file, ~54-line goose-modeled set.
What changed
.github/PULL_REQUEST_TEMPLATE.md— rewritten to 8 lines: Summary, Related issue (with inline duplicate-check prompt), Testing. Checklist and AI-disclosure section removed..github/ISSUE_TEMPLATE/bug-report.yml→bug-report.md— replaced YAML form with plain-markdown template (goose-style frontmatter). Fields: describe the bug, repro steps, expected behavior, version + OS, logs/context. Version guidance retained: Settings sidebar footer, "unknown" accepted..github/ISSUE_TEMPLATE/feature-request.yml→feature-request.md— replaced YAML form with plain-markdown template. Fields: motivation, proposed solution, alternatives, additional context. Duplicate-check line at the bottom (goose-style)..github/ISSUE_TEMPLATE/question.yml— deleted.config.ymlupdated toblank_issues_enabled: trueso questions have somewhere to go.CONTRIBUTING.md— "Before You Open a PR" compressed to four prose sentences: duplicate search, issue-first recommendation, AI ownership (absorbs the dropped PR-template field), review cadence. Intro link updated from the removed question form to plain/issues/new.Related issue
none found