Expresso Livre Comunidade

h1. Clonando o repositório do Expresso Livre

* Entre em um shell de comando, no usuário em que foi configurado o git;

* Crie uma pasta, em algum local do seu disco, para receber o repositório;

* Execute a clonagem:

<pre>
$ git clone http://git.expressolivre.org/expressolivre.git <pasta-local>
</pre>

h2. Desenvolva suas atualizações Crie um branch para o desenvolvimento da sua alteração

* Entre na pasta local, onde o repositório foi clonado clonado, e execute:

* Confirme se está no branch master executando o comando:

<pre>
$ git branch -a
</pre> &lt;nome-do-branch&gt;

* Desenvolva sua atualização normalmente. Isso irá criar um novo branch, no seu repositório local, com o nome indicado por &lt;nome-do-branch&gt;

* Não utilize o branch &#39;master&#39; ou o branch 'stable' para desenvolvimento.
Utilize, isto sim, um branch novo para cada implementação que vier a fazer no Expresso Livre
&lt;/pre&gt;

h2. Enviar suas alterações para o repositório remoto

* Teste sua implementação Implemente suas modificações, normalmente, sobre o branch criado, teste e quando estiver pronto para enviar, execute os comandos:

<pre>
$ git add *
$ git commit -m "Issue #<nnnn> - <comentário>"
$ git push

Onde:
<nnnn> corresponde ao número da Issue (tarefa) no Redmine
<comentário> é um texto resumido explicativo da alteração que está sendo realizada

Exemplo:
$ git commit -m "Issue #1885 - Implementa o construtor da classe Imap"
</pre>

h2. Observações

* Caso uma mensagem de commit esteja fora do padrão, o repositório remoto retornará um erro e o push não será efetivado;

* O repositório remoto está programado para aceitar um único commit por Issue;

* O repositório remoto irá recusar commits no ramo nos ramos &#39;master&#39; e 'stable';

* A única palavra-chave possível na mensagem do commit é 'Issue', iniciando com maiúscula;

* Somente apague o branch local, sobre o qual foi feito o desenvolvimento, depois que as alterações tiverem sido incorporadas ao repositório remoto;