Changes between Version 2 and Version 3 of Projeto/MetodologiaUsoTracSubversion

Timestamp:

05/14/09 14:58:03 (15 years ago)

Author:

niltonneto

Comment:

--

Projeto/MetodologiaUsoTracSubversion

@@ -1 +1 @@
 == Metodologia de Uso do Trac e Subversion no Expresso ==
 
-O uso do controlador de configurações Trac e do controlador de versões Subversion é essencial para realizar um bom gerenciamento de projetos onde há muitos participantes envolvidos, e no caso do expressoLivre, isto se faz ainda mais relevante pois há diversas empresas fazendo a todo instante um ''commit'' das suas implementações no repositório.
+O uso de um sistema para controle de mudanças em projetos de desenvolvimento de software, e de um sistema de controle de versões é essencial para realizar um bom gerenciamento de projetos onde há muitos participantes envolvidos, e no caso do expressoLivre. Isto torna-se ainda mais relevante quando há diversas empresas fazendo a todo instante um ''commit'' das suas implementações em um mesmo repositório.
 
-Este documento tem por objetivo disciplinar a utilização dessas duas ferramentas a fim de diminuir problemas comuns como a sobreposição de códigos ou a dificuldade de rastrear soluções.
+Este documento tem por objetivo disciplinar a utilização dessas duas ferramentas, no nosso caso foi adotado o Trac e o Subversion respectivamente, a fim de diminuir problemas comuns como a sobreposição de códigos ou a dificuldade de rastrear soluções.
 
 
 '''Abertura de Tickets'''
 
-Na abertura de um ticket o mais importante é que deve haver um e somente um ticket para cada problema, por menor que o problema seja, isto porque os procedimentos executados e os códigos vinculados a este problema serão facilmente rastreados posteriormente, o que facilitará a análise futura de como tal problema foi solucionado.
+Na abertura de um ticket o mais importante é que deve haver um, e somente um ticket para cada problema, por menor que o problema seja. Isto porque os procedimentos executados e os códigos vinculados a este problema serão facilmente rastreados posteriormente, o que facilitará a análise futura de como tal problema foi solucionado.
 
 Obviamente que haverá tickets com várias tarefas a serem feitas, como por exemplo criar módulo de relatórios, neste caso a resolução desse ticket será composta de uma série de códigos novos. Isto não será um problema desde que o ticket seja fechado somente quando o módulo como um todo tiver sido finalizado, pois aí os códigos vinculados ao ticket surgirão todos em função da criação do tal módulo.
@@ -29 +29 @@
 Na execução do ''commit'' que irá fechar um ticket a linha de comando deve ser a seguinte: 
 {{{
-svn ci -m “resolve #<número-do-ticket-que-está-sendo-fechado>”
+svn ci -m “Ticket #000 - <descrição com no mínimo 40 e no máximo 100 caracteres>”
 }}}
 
-O parâmetro -m é utilizado para registro de log do ''commit''. Neste log devem ser utilizadas as palavras reservadas Resolve e Corrige. Resolve indica o término da solução de um ticket. Corrige indica a retificação da solução de um ticket que foi fechado e depois reaberto pois a primeira solução foi falsa, incompleta, ou resultou em um efeito colateral. Seguido da palavra reservada deve ser usado o caracter # mais o número do ticket que está sendo fechado, com isto faz-se a amarração do ticket do Trac com o número da revisão do Subversion criando a tão necessária rastreabilidade, sendo portanto necessário anotar o número da revisão do repositório após o ''commit'' pois isto deverá ser utilizado no fechamento do ticket.
+O parâmetro -m é utilizado para registro de log do ''commit''. Seguido da palavra ''Ticket'' deve ser usado o caracter # mais o número do ticket que está sendo fechado, com isto faz-se a amarração do ticket do Trac com o número da revisão do Subversion criando a tão necessária rastreabilidade, sendo portanto necessário anotar o número da revisão do repositório após o ''commit'' pois isto deverá ser utilizado no fechamento do ticket.
 
 Não se deve armazernar no registro de log do ''commit'' nenhuma outra informação, pois isto acaba poluindo o registro exibido no Trac. Caso seja necessário inserir maiores detalhes sobre a solucão do ticket, isto deve ser posto no campo de comentário do Trac (comment) que cada ticket dispõe.