Colaborando com a localização Brasileira

Antes de continuar com este artigo você deve ter instalado o git, se não sabe como faze-lo acesse este link para as instruções de instalação:

No momento de escrita deste post temos duas versões da localização brasileira do Odoo.

https://github.com/odoo-brazil  - Mais atualizada e funcionando

e

https://github.com/OCA/l10n-brazil  - Ainda em processo de migração.

Qualquer ajuda nas duas versões são bem vindas..

Bom vamos lá, se você estiver pensando: "Não sei o que fazer, não tenho nenhuma necessidade de desenvolvimento" então o 1º Passo é acessar a lista de Pull Request e Issues do github:

Issues - seriam os problemas que existem em aberto na localização, necessitam ainda o desenvolvimento para se resolver, podem ser tanto bugs ou apenas melhorias e novas funcionalidades.

Pull Requests - são melhorias propostas por desenvolvedores para serem aceitas ao código oficial, estão ali porque necessitam que outros desenvolvedores ou pessoas testem e validem que aquilo está correto. Podem ainda estar associadas a algum "Issue" aberto, significando que aquele código corrige aquele problema.


Bom, agora já sei no que trabalhar, mãos a obra.

Agora que você já sabe o que vai fazer é bom deixar um comentário no 'Issue' que pretende trabalhar, ou mesmo que for algo novo, criar uma issue de melhoria para comunicar aos mantenedores do projeto que você está trabalhando nele, sempre tem alguém que pode lhe dar dicas.

Agora vamos criar nossa conta no github se ainda não possuir, e após isso vamos fazer um "Fork" do projeto:

O fork significa pegar uma cópia do projeto atual, com esta cópia temos o poder de alterar e enviar nossas correções novamente ao github diretamente em nosso "Fork" para posteriormente enviar ao repositório principal com as devidas correções.

Feito o Fork vamos clonar o projeto para a maquina localmente e começar a trabalhar no mesmo, para isso copiamos a seguinte url:

Hora de abrir o terminal:

Após o download vamos fazer nossas correções, mexemos na cor do link, corrigimos aquele bug complicado, etc.

Quando estiver tudo ok com as nossas mudanças voltamos ao terminal e acessamos a pasta onde foi feito o download e digitamos "git status"

Podemos notar que o git nos mostra quais arquivos foram modificados, se estiver ok vamos continuar.

Agora devemos efetuar o envio das modificações, para isto precisamo de três comandos:
git add    -- Adiciona os arquivos  que vão entrar no commit
git commit   -- Aplica as alterações e cria um histórico
git push   -- Envia as alterações para o github.

Após o git push devemos digitar nosso email e senha cadastrados no github, hora de acessar o github e ver se as nossa mudanças foram enviadas corretamente, lembre-se que fizemos um Fork, e clonamos o fork, então as mudanças foram enviadas para lá.

Chegou a hora de criamos nosso Pull Request:

Clicamos no link Pulll Request, verificamos se está tudo certo o que fizemos e após em "Create Pull Request",

Agora é só esperar que alguém que mantém a localização ver e testar o seu Pull Request.
Enquanto isso você pode ir testando os outros PR e dar um +1 quando estiver tudo certo.