ACTION REQUIRED: Default branch name change

Labels: area/meta/config kind/feature

Timeline

sudoforge opened (edited)

On May 31 2025 at approximately 17:00 UTC, the default branch for the git-bug repository will be changed from master to trunk.

Why is this being done?

The current default branch name is outdated and has negative connotations.

Why "trunk"?

trunk has history -- it is the traditional name for the primary development line in other version control systems like Subversion and CVS. It also aligns well with git's metaphors for "branches" and "trees" -- trunk feels semantically aligned and descriptive of it being the primary/core development line.

It also helps to emphasize a trunk-based development workflow, where branches are short-lived and the aim is to commit to trunk frequently.

What actions do I need to take?

If you have cloned this repository, you'll need to take a few actions in your local copy in order to change the default branch.

1. Rename your local default branch

git branch -m master trunk

2. Set the new default for origin/HEAD

git remote set-head origin trunk

NOTE If you have a different remote name for this git repository, be sure to reference that instead of origin.

3. Update any scripts or references to the old default branch

Be sure to update any scripts, packages, or other references to the old default branch name.


You can safely perform these migrations today. trunk will be kept up-to-date with the current default tree automatically.

After this change is made, this sync will be inverted: master will become a mirror of trunk. We will keep this pipeline in place until January 31 2026 to support downstream package maintainers who build from source.

sudoforge added label kind/feature

sudoforge added label area/meta/config

github-actions (github-actions) added label lifecycle/pinned

sudoforge removed label lifecycle/pinned