Skip to content

Clarify: adopted plugin branches must not merge master-forge into themselves - #349

Merged
mbastian merged 1 commit into
masterfrom
clarify-branch-adoption-doc
Sep 26, 2026
Merged

mbastian merged 1 commit into
masterfrom
clarify-branch-adoption-doc

Conversation

@mbastian

Copy link
Copy Markdown
Member

Summary

  • Adds one clarifying note to CONTRIBUTING.md's branch-adoption section: an adopted plugin branch should only ever sync with master, never have master-forge merged into it.
  • Prompted by a real slip: merging master-forge into an adopted branch to pre-resolve the <modules>-list conflict has the same effect as forking master-forge outright (which the doc already forbids) — every other plugin's tree ends up permanently on the branch, just via a merge commit instead of a clone. Caught before it was pushed for real, but the doc didn't call this specific case out.

Test plan

  • Docs-only change, no build impact.

🤖 Generated with Claude Code

…mselves

A branch adopted per "When a plugin's fork stops being a reliable
source of truth" should only ever sync with master. Merging
master-forge into it to pre-resolve the <modules>-list conflict has
the same effect as forking master-forge outright — every other
plugin's tree ends up permanently on the branch — just reached via a
merge commit instead of a clone.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@mbastian
mbastian merged commit d7b7906 into master Sep 26, 2026
2 checks passed
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