This Change will move Fedora git repositories to use "main" as the default git branch instead of "master". Specific repositories will be manually moved and default git branch for new projects will be set to use "main". src.fedoraproject.org/rpms (packages) will have a "rawhide" branch for rawhide with a symref (link) of "main".
The Fedora Community strives to be open and welcoming. Some language around our git repositories is dated and could be more inclusive. Many git repositories currently use "master" as the default branch. This Change will move many repositories (see below) to use a "main" branch as default. This small bit of naming adjustment is in-line with Fedora's vision for free and open source software built by inclusive, welcoming, and open-minded communities.
- Name: Kevin Fenzi, Ben Cotton, pingou, Mohan Boddu, Till Maas
- Email: firstname.lastname@example.org, email@example.com, firstname.lastname@example.org, email@example.com, firstname.lastname@example.org
- Targeted release: Fedora 34
- Last updated: 2021-02-08
- FESCo issue: #2519
- Tracker bug: #1908890
- Release notes tracker: #618
The Fedora Project controls a number of git repositories. This change will move the default branch (that is, the git branch used when nothing is specified) from 'master' to 'main'. Existing git clones will need to pull to get the changed default branch. Existing Pull Requests against the 'master' branch will need to be rebased against the 'main' branch. Documentation will be updated.
- Why not use "rawhide" for dist-git?
- Not every namespace on dist-git has a rawhide version. For example: containers do not have/use rawhide. And having different default branches on different namespaces is not very appealing.
Benefit to Fedora
The Fedora Project will be a more welcoming place for new contributors.
This change will take place in a number of phases:
Phase0 - 2021-01-05 - COMPLETE
A guide will be published to explain how maintainers/project managers can change the default branch on pagure.io, which they can then do based in their projects desires.
Phase1 - 2021-01-06 COMPLETE
The following repos will be switched:
pagure.io: releng releng/* fedora-comps fedora-kickstarts fedora-infrastructure fedora-lorax-templates fedora-mediawikitheme fedora-packager fedora-infra/* infra-docs koji-fedmsg-plugin workstation-ostree-config pungi-fedora fedora-docs/* fedora-docs-i18n/*
Phase2 - 2021-01-13 2021-01-27
Along with the src.fedoraproject.org changes, we will update the branch filter list and forbid 'master' from being pushed at all. Additionally, we will establish a sym-ref between 'rawhide' and 'main' as a convenience for people who prefer to use 'main' branch for rawhide.
pagure.io default for new projects will be changed to 'main'
- Proposal owners:
Documentation on how other projects can change these things if they wish Switching all above listed projects git repos to use 'main' Deleting the 'master' branch Announcing when changes have been made on devel-announce / other lists.
- Other developers:
Other developers are encouraged to change their upstream projects on pagure.io, github or gitlab.
- Release engineering:
Releng will adjust any scripts that assume 'master' branch to use 'main' instead. The list includes and maybe few more update-critpath.py block_retired.py update-docs.sh find_unblocked_orphans.py mass-rebuild-second-run.py adjust-eol-modules.py adjust-eol-modules.py adjust-eol-modules.py adjust-eol.py create-new-release-branches.py create-branch.py adjust-eol-all.py check-unretirement.py mass-rebuild-special.py need-rebuild.py distgit-branch-unused.py create-new-release-branches.py
- Policies and guidelines: N/A
- Trademark approval: N/A
- Alignment with Objectives:
Users with old checkouts will need to update their git configuration or re-clone repositories that have changed before they can see any new changes.
Repos used to build content for docs.fedoraproject.org can change the default git branch, but the Antora module version (in
antora.yml) should remain
master pending support for alternate "unversioned" versions upstream.
How To Test
- git clone <one of the listed repositories>
- cd <repositoryname>
- git branch
Users and developers will see more welcoming language and that the fedora project expended effort to be more welcoming to them.
- Contingency mechanism: Revert repositories, scripts, and docs back to the unwelcoming 'master'
- Contingency date: 2020-01-13
A short guide on how to change this for pagure.io will be produced.
Once the migration is over, packagers can run the following command to migrate their local clones to the new structure:
git fetch # optionally with -p / --prune git branch -m master rawhide git branch -u origin/rawhide rawhide
If you have multiple git repos, you can apply the following script:
for i in /path/to/dist/fedora/*/; do ( pushd $i && git fetch -p && git branch -m master rawhide && git branch -u origin/rawhide rawhide ) done |& tee /path/to/output
If you have used a different remote name than 'origin', you will need to adjust these commands accordingly
(Credit: Todd Zullinger)
Many git repositories used to create Fedora releases were moved to use a 'main' branch instead of a 'master' branch. The Fedora Project envisions a world where everyone benefits from free and open source software built by inclusive, welcoming, and open-minded communities.