Skip to content

docs: adopt dev/main branching model for public contributions - #17

Merged
tyler-rich merged 1 commit into
mainfrom
claude/dev-main-branching-model-0t2094
Jul 4, 2026
Merged

docs: adopt dev/main branching model for public contributions#17
tyler-rich merged 1 commit into
mainfrom
claude/dev-main-branching-model-0t2094

Conversation

@tyler-rich

@tyler-rich tyler-rich commented Jul 4, 2026

Copy link
Copy Markdown
Owner

Summary

Scrye is moving toward accepting public/external contributions, so this switches the project to a dev/main branching model:

  • main is now treated as protected, receiving only tagged releases (branch protection itself is configured separately in GitHub settings, not by this PR).
  • A new dev integration branch has been cut from main and pushed — it's the default branch for day-to-day work and external contributions.
  • Feature/fix branches are created from dev and PR'd into dev by default. Promotion from dev to main is a separate, deliberate PR made only when explicitly cutting a release, followed by tagging main.

What changed

  • CLAUDE.md — § Git & PR conventions now describes the dev/main model; all existing rules (git identity, no attribution footers, CI-green, deviations logging) are unchanged and now apply against dev as the usual PR target.
  • CONTRIBUTING.md — added a new § Branching model for external contributors, updated the branch-naming guidance and PR process to target dev, and added a § Releasing section describing the devmain promotion + tag flow.
  • docs/PLAN.md — logged this workflow change in § Deviations.

This PR itself is a process/docs change targeting main (describing the new model), not a code contribution — per the new model, ordinary work will target dev going forward.

main is now protected and reserved for tagged releases; dev becomes the
integration branch for day-to-day work and external contributions. Feature/fix
branches are created from dev and PR'd into dev by default, with promotion to
main a separate, explicit release step.

Updates CLAUDE.md's Git & PR conventions, adds a Branching model section and
updates Releasing/PR process in CONTRIBUTING.md, and logs the change in
docs/PLAN.md § Deviations.
@tyler-rich
tyler-rich merged commit b04f32c into main Jul 4, 2026
4 checks passed
tyler-rich added a commit that referenced this pull request Jul 4, 2026
Brings the dev/main branching-model docs (from main, #17) into dev and
resolves the docs/PLAN.md Deviations-log conflict by keeping both 2026-07-04
entries (Docker Hub publishing + dev/main branching model). Unblocks the
dev -> main promotion PR (#19).
@tyler-rich
tyler-rich deleted the claude/dev-main-branching-model-0t2094 branch July 6, 2026 06:43
tyler-rich added a commit that referenced this pull request Jul 9, 2026
Brings the dev/main branching-model docs (from main, #17) into dev and
resolves the docs/PLAN.md Deviations-log conflict by keeping both 2026-07-04
entries (Docker Hub publishing + dev/main branching model). Unblocks the
dev -> main promotion PR (#19).
tyler-rich added a commit that referenced this pull request Jul 9, 2026
main is now protected and reserved for tagged releases; dev becomes the
integration branch for day-to-day work and external contributions. Feature/fix
branches are created from dev and PR'd into dev by default, with promotion to
main a separate, explicit release step.

Updates CLAUDE.md's Git & PR conventions, adds a Branching model section and
updates Releasing/PR process in CONTRIBUTING.md, and logs the change in
docs/PLAN.md § Deviations.
tyler-rich added a commit that referenced this pull request Jul 9, 2026
Brings the dev/main branching-model docs (from main, #17) into dev and
resolves the docs/PLAN.md Deviations-log conflict by keeping both 2026-07-04
entries (Docker Hub publishing + dev/main branching model). Unblocks the
dev -> main promotion PR (#19).
tyler-rich added a commit that referenced this pull request Jul 9, 2026
main is now protected and reserved for tagged releases; dev becomes the
integration branch for day-to-day work and external contributions. Feature/fix
branches are created from dev and PR'd into dev by default, with promotion to
main a separate, explicit release step.

Updates CLAUDE.md's Git & PR conventions, adds a Branching model section and
updates Releasing/PR process in CONTRIBUTING.md, and logs the change in
docs/PLAN.md § Deviations.
tyler-rich added a commit that referenced this pull request Jul 9, 2026
Brings the dev/main branching-model docs (from main, #17) into dev and
resolves the docs/PLAN.md Deviations-log conflict by keeping both 2026-07-04
entries (Docker Hub publishing + dev/main branching model). Unblocks the
dev -> main promotion PR (#19).
tyler-rich added a commit that referenced this pull request Jul 9, 2026
main is now protected and reserved for tagged releases; dev becomes the
integration branch for day-to-day work and external contributions. Feature/fix
branches are created from dev and PR'd into dev by default, with promotion to
main a separate, explicit release step.

Updates CLAUDE.md's Git & PR conventions, adds a Branching model section and
updates Releasing/PR process in CONTRIBUTING.md, and logs the change in
docs/PLAN.md § Deviations.
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