Git things: Renaming your working branch

ls — Sun, 21 May 2023 19:30:37 +0000

I drafted this post years ago and never hit "Publish". :)

As a developer, I have been working with various proprietary tools for most of my professional life. Recently, I started working on some personal projects where I needed to use Git, an open-source tool for version control. I have to admit, I made silly mistakes while navigating Git at first. But, with some practice and research, I have learned how to use it effectively.

Something I struggled with initially was renaming a working branch in Git. It's a common task that developers need to do quite often, but I found it challenging initially. After some research and experimentation, I have come up with a goto-guide.

Here is my step-by-step guide to rename a working branch in Git on both local and remote setups:

Renaming a branch locally

First, navigate to the local branch that you want to rename using the command:

git checkout <branch-name>
Then, rename the branch using the command:

git branch -m <new-branch-name>
This will rename the current branch to the new branch name.

Pushing renamed branch to remote

After renaming the branch locally, push the changes to the remote repository using the command:

git push origin -u <new-branch-name>
This will push the renamed branch to the remote repository.

Deleting old branch on remote

If you want to delete the old branch from the remote repository, use the command:

git push origin --delete <old-branch-name>
This will delete the old branch from the remote repository.

How do I manage branch renaming with my team members or other contributors?

Here are some things that have really helped me navigate conflicts during branch naming:

Communicate with your team about the branch renaming and coordinate with members who have branches based on the original branch.
Merge or rebase changes from affected branches onto the renamed branch. To merge changes from an affected branch onto the renamed branch run git merge <affected-branch> To rebase the changes from an affected branch onto the renamed branch, you can run: git rebase <renamed-branch>
Talk through situations where you need a rebase or a merge with your team.
Update remote branches and repositories by running git push -u origin <renamed-branch> Ask your team to update changes to their local repositories. Once all this gets done, consider removing the old branch to keep this clean.

That's it! You have successfully renamed a working branch in Git on both local and remote setups.

Happy coding!

Nevertheless, I Coded

ls — Wed, 07 Mar 2018 21:54:52 +0000

I began/continue to code because...

I wanted to build impactful products with great user experiences.

I recently overcame...

Impostor Syndrome. It's intermittent, but real.

I want to brag about...

My love for coffee and sneakers, and my passion for yoga.

My advice for allies to support women and non-binary folks who code is....

You're here to create and achieve great things.
Use your voice, your strength and win by the hour!

DEV Community: ls