86.8 Git Branch Naming

20220405

A common convention for naming branches is to begin with a token, then a slash, then a descriptive name, like feat/searchbar. This can be problematic as when URIs are added to the branch the slash becomes ambiguous. Nonetheless, the use of slash is common and supported by some of the git tools.

Common tokens include feat (feature), wip (work in progess), bug, new, test, dev, doc.

For a team working on a project, where each member is generally responsible for different activities, it is highly recommended the token be the user’s name, like kayon/addcolour. This naming scheme makes it clear who is responsible for a particular branch, but should not discourage others from contributing to that branch through pull requests.



Your donation will support ongoing availability and give you access to the PDF version of this book. Desktop Survival Guides include Data Science, GNU/Linux, and MLHub. Books available on Amazon include Data Mining with Rattle and Essentials of Data Science. Popular open source software includes rattle, wajig, and mlhub. Hosted by Togaware, a pioneer of free and open source software since 1984. Copyright © 1995-2022 Graham.Williams@togaware.com Creative Commons Attribution-ShareAlike 4.0