View on GitHub

manual-da-engenharia-para-codar

Este é o manual para compromissos de "código com" a engenharia.

Dando nomes para branches

Ao contribuir para projetos existentes, é importante buscar e aderir à convenção de nomenclatura de branches acordada. Em projetos de código aberto, essa informação geralmente é encontrada nas instruções de contribuição, muitas vezes em um arquivo chamado CONTRIBUTING.md.

No início de um novo projeto, a equipe concorda com as convenções do projeto, incluindo a estratégia de nomenclatura de branches.

Aqui está um exemplo de uma convenção de nomenclatura de branch:

<alias do usuário>/[recurso/bug/hotfix]/<ID do item de trabalho>_<título>

Isso pode se traduzir em algo como:

dickinson/recurso/271_adicionar_mais_cowbell

O exemplo acima é apenas isso - um exemplo. A equipe pode optar por omitir ou adicionar partes. A escolha de uma convenção de nomenclatura de branch pode depender do modelo de desenvolvimento (por exemplo, desenvolvimento baseado no tronco), modelo de versionamento, ferramentas usadas para gerenciar o controle de código, questões de gosto, etc. Concentre-se na simplicidade e na redução de ambiguidade; uma boa estratégia de nomenclatura de branch permite que a equipe compreenda o propósito e a propriedade de cada branch no repositório.