Skip to content

Add CONTRIBUTING + issue/PR templates#10

Merged
fsjobeck merged 1 commit intomainfrom
chore/contrib-templates
May 2, 2026
Merged

Add CONTRIBUTING + issue/PR templates#10
fsjobeck merged 1 commit intomainfrom
chore/contrib-templates

Conversation

@fsjobeck
Copy link
Copy Markdown
Member

@fsjobeck fsjobeck commented May 1, 2026

Summary

Scaffolds GitHub's contribution surfaces:

File Purpose
CONTRIBUTING.md Dev setup, branch conventions, what we expect in PRs, scope guardrails (no scope creep into backend/analytics)
.github/ISSUE_TEMPLATE/bug_report.yml Form-style bug report; the zone-snippet field renders as preformatted text so whitespace is preserved
.github/ISSUE_TEMPLATE/feature_request.yml Form-style feature request, with a dropdown that asks whether the idea fits the self-operating philosophy
.github/ISSUE_TEMPLATE/config.yml Disables blank issues; routes questions to Discussions and security to GitHub Security Advisories
.github/PULL_REQUEST_TEMPLATE.md Summary + test plan + screenshots, plus a checklist mirroring the CONTRIBUTING expectations

Test plan

  • CI passes
  • After merge, "New issue" on the repo offers the two templates and hides "blank issue"
  • Opening a new PR pre-fills the template body
  • CONTRIBUTING shows up linked at the bottom of the GitHub repo "Insights → Community Standards" checklist

Notes

No code changes. The Discussions link in config.yml assumes Discussions is enabled on the repo — if it's not, GitHub will quietly skip that contact link until it is.

🤖 Generated with Claude Code

Three structured surfaces for outside contributors:

- CONTRIBUTING.md — short guide. Dev setup link to README, branch
  conventions, what we expect in PRs (tests for new logic, no new
  runtime deps without reason, no analytics/trackers, strict CSP),
  no-style-config-yet caveat, and the implicit MIT licensing.
- .github/ISSUE_TEMPLATE/bug_report.yml — GitHub form with fields
  for the bug, an optional zone snippet (rendered as plain-text so
  it preserves whitespace), expected behavior, where it happens,
  browser, and console errors.
- .github/ISSUE_TEMPLATE/feature_request.yml — form steered to
  "what problem" first, then proposed solution, with a dropdown
  asking whether the idea fits the self-operating philosophy.
- .github/ISSUE_TEMPLATE/config.yml — disables blank issues; routes
  questions to Discussions and security reports to GitHub Security
  Advisories.
- .github/PULL_REQUEST_TEMPLATE.md — Summary + Test plan + Screenshots
  sections plus a checklist mirroring the CONTRIBUTING expectations.

No code changes; all four files pure scaffolding for the GitHub UI.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@fsjobeck fsjobeck merged commit 2cc221c into main May 2, 2026
2 checks passed
crhaglun pushed a commit that referenced this pull request May 8, 2026
Three structured surfaces for outside contributors:

- CONTRIBUTING.md — short guide. Dev setup link to README, branch
  conventions, what we expect in PRs (tests for new logic, no new
  runtime deps without reason, no analytics/trackers, strict CSP),
  no-style-config-yet caveat, and the implicit MIT licensing.
- .github/ISSUE_TEMPLATE/bug_report.yml — GitHub form with fields
  for the bug, an optional zone snippet (rendered as plain-text so
  it preserves whitespace), expected behavior, where it happens,
  browser, and console errors.
- .github/ISSUE_TEMPLATE/feature_request.yml — form steered to
  "what problem" first, then proposed solution, with a dropdown
  asking whether the idea fits the self-operating philosophy.
- .github/ISSUE_TEMPLATE/config.yml — disables blank issues; routes
  questions to Discussions and security reports to GitHub Security
  Advisories.
- .github/PULL_REQUEST_TEMPLATE.md — Summary + Test plan + Screenshots
  sections plus a checklist mirroring the CONTRIBUTING expectations.

No code changes; all four files pure scaffolding for the GitHub UI.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant