DEV Community

loading...
Cover image for How to rename your master branch to something else

How to rename your master branch to something else

mrsaeeddev profile image Saeed Ahmad ・2 min read

GitHub Master to Main

Well, we all might have heard that GitHub will remove the master naming convention for default branch.

Source: https://www.bbc.com/news/technology-53050955

GitHub's Twitter page posted that it stands with the black community and the fight against racism.

There are many people who might be looking to rename their branch to something more clearer and better.

First of all let's understand what a master branch is?

In Git, "master" is a naming convention for a branch. After cloning (downloading) a project from a remote server, the resulting local repository has a single local branch: the so-called "master" branch. This means that "master" can be seen as a repository's "default" branch.

Why we are doing this?

The master-slave relationship in technology usually refers to a system where one - the master - controls other copies, or processes.

The years-old campaign to replace such terms has been given fresh impetus amid the resurgence of Black Lives Matter protests in the United States.

Mr Friedman's announcement came in a Twitter reply to Google Chrome developer Una Kravets, who said she would be happy to rename the "master" branch of the project to "main".

"If it prevents even a single black person from feeling more isolated in the tech community, feels like a no-brainer to me," she wrote. (Excerpt from BBC Report)

What are potential alternate names for master branch?

Alternate names can be:

  • main
  • edge
  • release
  • prod
  • production
  • live
  • default
  • head
  • primary
  • top

How to rename master branch to some other name?

Let's name our master branch to release

i. Checkout your master branch

git checkout master

ii. Create your release branch and switch to it

git branch release
git checkout release

iii. Push that to the server

git push origin release

iv. Delete the master branch reference on the server

git push origin :master

v. Delete the local master branch

git branch -d master

Your thoughts!

Let me know what can be a more better name for master branch?

Share your ideas in the comments section so that it's easier for new developers and programming community to decide the alternative or I must say original names for both terminologies.

Thank you for reading

🖤 #BlackLivesMatter 🖤

Discussion (21)

pic
Editor guide
Collapse
codemouse92 profile image
Jason C. McDonald

I'll be adopting devel for my team's repositories, complementary to our fresh and stable branches.

Collapse
ben profile image
Ben Halpern

We're looking at...

edge (master)
testing (alpha)
release (beta)
stable
Collapse
codemouse92 profile image
Jason C. McDonald

Oooooo, I like edge even better than devel. I think I'll have to discuss this with my team.

The beautiful upshot of renaming master is that we can reopen some important conversations about repository workflow. We've all taken the master branch for granted, but we all use it differently. Perhaps its time we change that, and perhaps this will help.

Thread Thread
mrsaeeddev profile image
Saeed Ahmad Author

Yeah exactly. Now, we can rethink our strategies regarding that.

Collapse
mrsaeeddev profile image
Saeed Ahmad Author

I really like these names. Thank you for sharing Ben!

Collapse
mrsaeeddev profile image
Saeed Ahmad Author

Oh yes. These names sound good too.

Collapse
roshnet profile image
Roshan Sharma

Hey, nice post!
I'd like to add a bit though
git branch -m master main
to rename, followed by a push also seems to work fine.

Collapse
mrsaeeddev profile image
Saeed Ahmad Author

Thank you so much. I'll try this one-liner. This is more concise.

Collapse
jessehouwing profile image
Jesse Houwing • Edited

Careful though... I did this on one repo where, as it turned out the master wasn't up to date with origin. So, from that moment on, I relied on branching from
origin/master instead of my local master after performing a fetch.

Thread Thread
mrsaeeddev profile image
Saeed Ahmad Author

I haven't tried it yet but thank you for pointing this out.

Collapse
matthewadams profile image
Matthew Adams

Surprised you didn’t suggest “trunk”.

Collapse
mrsaeeddev profile image
Saeed Ahmad Author

Oh yes. It sounds great.

Collapse
matthewadams profile image
Matthew Adams

...and goes back a long, long way.

Collapse
mrsaeeddev profile image
Saeed Ahmad Author • Edited

Well, I'd prefer to name them as main (master), dev, test, and feature. I think to name them like that because it is more clear for the team. Even it's for the other people, you just look at the branch name and you get its purpose.

Collapse
what_hack profile image
Comment marked as low quality/non-constructive by the community. View Code of Conduct
WhatAHack

Oh, ye, sure that will change anything, you can also rebrand every cable on your pc. F U poser

Some comments have been hidden by the post's author - find out more