Skip to content

docs: add public community templates - #1

Merged
midagedev merged 1 commit into
mainfrom
chunk-b-community-files
May 9, 2026
Merged

docs: add public community templates#1
midagedev merged 1 commit into
mainfrom
chunk-b-community-files

Conversation

@midagedev

Copy link
Copy Markdown
Owner

Summary

  • Adds public community files for conduct, support, issue routing, and PR review expectations.
  • Adds GitHub issue templates for bugs, feature requests, and public security/boundary concerns.
  • Updates README, CONTRIBUTING, and SECURITY links/routing while preserving the no-real-payment boundary.

Verification

  • ruby -ryaml -e 'ARGV.each { |f| YAML.load_file(f); puts "ok #{f}" }' .github/ISSUE_TEMPLATE/*.yml
  • git diff --check
  • content scan for real-payment boundary language and support/security routing
  • confirmed no diff to .github/workflows/zai-review.yml, LICENSE, package.json, package-lock.json, or docs/RELEASE_CHECKLIST.md in the PR worktree

Open risks

  • Repository labels referenced by templates may need to exist or be created by maintainers.
  • GitHub private security advisories should be enabled for the repository before broad public intake.

Gate status

  • G9 Release Candidate support: community intake docs improved; product/runtime gates not applicable for this documentation-only PR.

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

APPROVE

Summary

이 PR은 Billtap의 public community intake 시스템을 구축하는 문서 추가 변경입니다. GitHub issue 템플릿, PR 템플릿, Code of Conduct, Support 가이드를 추가하고 기존 문서의 routing을 개선했습니다.

Safety & Boundary Review

✅ Production Boundary 명확성

모든 새 문서가 Billtap의 "billing sandbox not payment processor" 경계를 명확히 합니다:

  • bug_report.yml: required checkbox로 "Billtap is a billing sandbox and not a real payment processor" 확인
  • feature_request.yml: "out of scope" 섹션에서 real payment processing, production payment dependency를 명시적 거부
  • CODE_OF_CONDUCT.md: "Product Safety Boundary" 섹션에서 no real card processing, no live payment credentials, no production payment dependency 강조

✅ Security Routing 분리

SECURITY.mdsecurity_boundary.yml가 적절히 분리되었습니다:

  • Private: secret exposure, real card data, webhook-signature bypass, relay-mode bypass → SECURITY.md private advisory
  • Public: documentation questions, boundary clarifications, no-vulnerability disclosure → public issue template

✅ Support Channel 명확화

SUPPORT.md가 올바른 routing을 제공합니다:

  • Issues: bugs, feature requests (sandbox scope 내)
  • PRs: focused fixes, fixture-backed improvements
  • Security: vulnerabilities, secret exposure, bypasses
  • Out of Scope: live payment operations, real card processing, Stripe production replacement

Documentation Quality

✅ Issue Template 구조

모든 템플릿이 요구사항에 부합합니다:

  1. Area dropdown: spec.md와 일치하는 카테고리 (API compatibility, Billing state, Checkout UI, Portal UI, Dashboard, Webhooks, Scenario runner, Fixtures, SaaS profile, Production boundary)
  2. Safety boundary checkboxes: required 체크박스로 실제 결제 데이터/credential 제거 강제
  3. Environment dropdown: "Controlled staging-adjacent relay mode"가 relay mode의 bounded nature 반영

✅ PR Template 구조

PULL_REQUEST_TEMPLATE.md가 요구사항을 포함합니다:

  • Scope checkboxes (sandbox boundary, no live credentials)
  • Verification checklist (go test, npm typecheck/build, scenario run)
  • Compatibility/boundary notes field for behavior changes

✅ CONTRIBUTING.md 개선

CONTRIBUTING.md 개선사항:

  • Issue/PR flow 섹션 추가 (template 사용, security routing 명시)
  • Documentation-only changes에 대한 review criteria 추가 (clear routing, no-real-payment language, working links)
  • "Out of scope" 섹션으로 명확한 경계 설정

Gate Alignment

  • G9 Release Candidate support: community intake docs가 pre-release 상태에 적합한 "best effort" support expectation을 설정합니다

Minor Notes

  1. config.ymlcontact_linksPRODUCTION_BOUNDARIES.md를 참조하는데, 이 파일이 아직 존재하지 않을 수 있습니다. 나중에 해당 문서를 추가하거나 링크를 조정해야 할 수 있습니다.

  2. YAML validation은 PR author가 이미 수행했다고 명시했으므로 별도 검증 없이 진행합니다.

Conclusion

이 PR은 Billtap의 production boundaryno-real-payment 원칙을 모든 community touchpoint에서 일관되게 강화합니다. 문서만 변경되었으며, billing state, webhook reliability, safety에 영향을 주는 코드 변경은 없습니다.

Blocking issue 없습니다.

Reviewed by Z.ai GLM via Claude Code Action

@midagedev
midagedev merged commit 76429c1 into main May 9, 2026
1 check passed
@midagedev
midagedev deleted the chunk-b-community-files branch May 9, 2026 05:58
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