ti-enxame.com

Boa convenção de nomenclatura para ramos nomeados em {DVCS} de sua escolha

Estamos integrando o Mercurial lentamente em nosso escritório e fazendo desenvolvimento web, começamos a usar filiais nomeadas.

Ainda não encontramos uma boa convenção no que diz respeito a nomear nossos branches.

Nós tentamos:

  • FeatureName (pode ver isso causando problema no futuro)
  • DEVInitial_FeatureName (pode ficar confuso quando o desenvolvedor entra e sai da linha)
  • {uniqueID (int)} _ Recurso

Até o momento o uniqueID_featureName está ganhando, estamos pensando em mantê-lo em um pequeno banco de dados apenas para referência.

Teria: branchID (int), featureName (varchar), featureDescription (varchar), data, quem etc ...

Isso nos daria branches como: 1_NewWhizBangFeature, 2_NowWithMoreFoo, ... e teríamos uma referência fácil sobre o que esse branch faz sem ter que verificar o log.

Alguma solução melhor por aí?

16
jfrobishow

Se você não tiver um rastreador de problemas, recomendo configurar um e usar {nome do rastreador de problemas} _ {número do tíquete}. Quando alguém daqui a anos arquivar um bug e você não souber exatamente como o recurso deveria funcionar, será fácil anotar o arquivo e voltar para onde o usuário pode ter solicitado essa funcionalidade exata.

14
Asa Ayers

Recomendo usar este formulário (por exemplo):

 BUG_ID 
 BUG # ID 
 TICKET_ID 
 TICKET # ID 
 Feature_bla-bla-bla 
 Release-x.xx.xx 
 release_x.xx.xx 
 build_2010-20-12 
 build_4565 
 FILIAL_x.xx.xx 

Basta selecionar bons prefixos (para permitir a saída do filtro de ramos hg), regra de capitalização e delimitador entre prefixo e ID/nomes.

2
gavenkoa

Eu sugiro mantê-lo simples e nomear ramos de acordo com FeatureName (ou feature-name) convenção. Sim, isso significa um namespace compartilhado, mas raramente é um problema no mundo real. Uma vez que um recurso é feito e completamente mesclado na linha principal, o branch pode ser excluído com segurança.

A ideia principal do controle de versão distribuído é que ele deve ser fácil de ramificar, a introdução de burocracia adicional, como o id único obrigatório, só vai tornar isso mais difícil.

2
Adam Byrtek