Clonando o Repositório do ExpressoLivre

O modelo de desenvolvimento do Github prevê que cada desenvolvedor tenha a sua própria área de repositórios para realizar o seu trabalho, e quando tiver com uma manutenção concluída, envie os dados para o repositório principal, através de pull-request. Portanto, sugerimos a seguinte sequência para que um desenvolvedor comece a colaborar com o ExpressoLivre:

Passo 1: criar uma conta GitHub

• Na página principal do Github, informe os dados para criação de uma conta pessoal.

Passo 2: clonar o repositório ExpressoLivre:

• Entre na sua conta e, estando autenticado, vá para a página do repositório ExpressoLivre, em:

https://github.com/ComunidadeExpresso/expressolivre

• Clique sobre o botão 'Fork'

Isso irá clonar o repositório ExpressoLivre na sua área pessoal de repositórios.

Passo 3: instalar o aplicativo git no seu computador local

• Siga o roteiro da página: Instalação e Configuração do Git

Passo 4: clonar o repositório ExpressoLivre para o seu computador pessoal

• Entre em um shell de comando, no usuário em que foi configurado o git;
• Crie uma pasta, em algum local do disco, para receber o repositório;
• Execute a clonagem:

$ git clone https://github.com/<seu-usuario-github>/expressolivre.git <pasta-local>

Passo 5: crie um branch para o desenvolvimento da sua alteração

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

$ git branch <meu-branch>

Isso irá criar um novo branch, no seu repositório local, com o nome indicado por <meu-branch>

Não utilize o branch master. Utilize, isto sim, um branch para cada implementação que vier a fazer no ExpressoLivre

Passo 6: enviar suas alterações para o projeto principal

• Implemente suas modificações, normalmente, sobre o branch criado, teste e quando estiver pronto para enviar, execute os comandos:

$ git add *
$ git commit -m "<mensagem>"
$ git push

Utilize o formato de <mensagem> como está descrito na página Comandos Básicos do Git

Passo 7: solicitar o pull-request

Depois de executado os passos anteriores, sua modificação deverá estar presente no seu repositório pessoal do Github

• Entre no seu repositório ExpressoLivre, no Github;
• Posicione no branch da sua contribuição;
• Clique sobre o botão 'Pull-request'.

Isso irá registrar uma solicitação (issue) no projeto ExpressoLivre principal, e ficará aguardando o merge ser feito pelo usuário moderador, que avalia as contribuições e as incorpora no repositório principal.

Somente apague o branch, a partir do qual foi feito o pull-request, depois que as alterações tiverem sido incorporadas no repositório principal.