84.7 Git Branch Naming

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

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

For a team the token may be the user’s name, like kayon/addcolour. In general this is discouraged as it can lead to a hesitation of others to contribute to that branch as it appears to be owned by Kayon. If that is the intention then that is fine. Otherwise avoid this apparent ownership becoming a blocker to others contributing.



Your donation will support ongoing development 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-2021 Graham.Williams@togaware.com Creative Commons Attribution-ShareAlike 4.0.