---
# System prepended metadata

title: Change Proposal Name Welcoming-language-for-git-repos
tags: [' infra', wiki]

---

---
title: Change Proposal Name Welcoming-language-for-git-repos
tags: wiki, infra

---
= Change Proposal Name Welcoming-language-for-git-repos

== Summary ==

The Fedora community strives to be open and welcoming. Some language around our git repositories could be improved
to be more welcoming. Currently many of our git repositories use 'master' as the default branch. This change will 
move many of those repostories to use a 'main' branch as default. This small bit of naming adjustment will 
help show that Fedora is committed to being welcoming to newcomers and existing community members alike.

== Owner ==

* Name: [[User:Kevin| Kevin Fenzi]]
* Email: kevin@scrye.com

== Current status ==
[[Category:ChangePageIncomplete]]
<!-- When your change proposal page is completed and ready for review and announcement -->
<!-- remove Category:ChangePageIncomplete and change it to Category:ChangeReadyForWrangler -->
<!-- The Wrangler announces the Change to the devel-announce list and changes the category to Category:ChangeAnnounced (no action required) --> 
<!-- After review, the Wrangler will move your page to Category:ChangeReadyForFesco... if it still needs more work it will move back to Category:ChangePageIncomplete-->

<!-- Select proper category, default is Self Contained Change -->
[[Category:SelfContainedChange]]
<!-- [[Category:SystemWideChange]] -->

* Targeted release: [[Releases/34 | Fedora 34 ]] 
* Last updated: <!-- this is an automatic macro — you don't need to change this line -->  {{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}} 
* FESCo issue: <will be assigned by the Wrangler>
* Tracker bug: <will be assigned by the Wrangler>
* Release notes tracker: <will be assigned by the Wrangler>

== Detailed Description ==

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 PR's against the 'master' branch will need to be rebased against
the 'main' branch. Documentation will be updated. 

== Feedback ==


== Benefit to Fedora ==

The Fedora project will be a more welcoming place for new contributors.


== Scope ==

This change will take place in a number of phases:

Phase0 - 2020-12-07

	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 - 2020-12-08

The following repos will be switched:

src.fedoraproject.org/flatpacks/*
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
github.com
	fedora-infra/*

Phase2 - 2021-01-13

	src.fedoraproject.org/*
	pagure.io default for new projects will be changed to 'main'

* Proposal owners:

	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.

* Policies and guidelines: N/A 

* Trademark approval: N/A

* Alignment with Objectives: 

== Upgrade/compatibility impact ==

Users with old checkouts will need to re-clone repositories that have changed before they can see
any new changes.

== How To Test ==

git clone <one of the listed repositories>
cd <repositoryname>
git branch
should return: * main

== User Experience ==

Users and developers will see more welcoming language and that the fedora project expended effort
to be more welcoming to them. 

== Dependencies ==

none

== Contingency Plan ==

Repositories could be reverted back to the unwelcoming 'master' name.

== Documentation ==

A short guide on how to change this for pagure.io will be produced.

== Release Notes ==

Many of the git repositories that are used to create Fedora releases have been moved to use
a 'main' branch instead of a 'master' branch. The Fedora project strives to be a welcoming
project for everyone.