Para melhor organização, primeiro informe o(s) documento(s) que pretende ajudar na tradução e/ou revisão na planilha de tradutores/revisores: https://spreadsheets.google.com/ccc?key=0AtX-XMIXR2DAdFBMekh4UktObUNOMy1NX2RSMjJMUUE
Se ainda não possuir acesso de edição nesta planilha, solicitar o acesso para andreiabohner at gmail dot com.
Para começar, faça o fork do repositório master da tradução para o português no github:
1.1 Acessar o repositório master no github: https://github.com/andreia/symfony-docs-pt-BR 1.2 Clicar no botão fork
Agora, você irá "clonar" o projeto para a sua máquina local:
2.1 Copiar a URL do repositório do seu fork, para utilizá-la com o comando git clone (por exemplo):
$ git clone git@github.com:seuusername/symfony-docs.git
2.2 Após completar o clone do repositório, ele terá o nome remoto "origin". Não confundir, apesar do nome ser origin ele não está apontando para o repo master, mas sim para o seu fork no github.
- Copie o(s) documento(s) que você irá traduzir (verifique se os mesmos já não foram traduzidos em https://github.com/andreia/symfony-docs-pt-BR) do repositório oficial em inglês ( https://github.com/symfony/symfony-docs ).
Pronto, agora é só trabalhar na tradução do(s) documento(s).
Copie o(s) documento(s) que você traduziu para os respectivos diretórios em seu repositório local (o que você criou no passo 2).
Finalizadas as traduções e/ou revisões, adicione os novos documentos (se for uma nova tradução) e faça o commit das alterações no seu repositório local:
$ git add <nome_do_arquivo> $ git commit –a –m "pt_BR translation"
Atualize o seu repositório no servidor github com as alterações realizadas localmente:
$ git push origin master
O último passo é informar sobre as suas alterações ao responsável pelo repositório de origem, para realizar um pull das alterações no repositório. Para isso, acesse a página do repositório original no github, em: https://github.com/andreia/symfony-docs-pt-BR e envie um pull request (clicando no botão "Pull Request"): Mais informações sobre o Pull Request
Sempre antes de fazer as suas alterações locais, lembrar de executar o comando pull para manter atualizado o seu repositório local trazendo as alterações do repositório de origem (o repositório que você fez o fork):
$ git remote add upstream git@github.com:andreia/symfony-docs-pt-BR.git $ git pull upstream master
As mensagens dos commits devem ser todas em INGLÊS e devem ter o seguinte prefixo: [pt_BR][Livro][Capítulo] seguido da mensagem do commit. Ex.: Se você estiver traduzindo o capítulo 'Validation' do livro, a mensagem do commit poderia ser semelhante a seguinte: [pt_BR][Book][Validation] Fix typo.
Dica: Escrevendo boas mensagens de commit: https://github.com/erlang/otp/wiki/Writing-good-commit-messages
Os códigos serão mantidos todos em inglês.
A documentação do Symfony2 utiliza a linguagem markup reStructuredText juntamente com o Sphinx. Segue a referência: http://symfony.com/doc/2.0/contributing/documentation/format.html Se preferir, existe um editor online, que pode auxiliar em: http://rst.ninjs.org/
Para mantermos consistente a tradução dos documentos, verifique no glossário os termos que não devem ser traduzidos e aqueles que devem seguir a mesma tradução: http://andreia.github.com/symfony-docs-pt-BR/
Para facilitar a revisão dos documentos, sempre que uma nova tradução é adicionada/modificada aqui no repositório ela é renderizada no seguinte endereço: http://andreiabohner.org/symfony2docs/index.html
- SSH issues: Guia contendo as soluções para os problemas mais comuns referentes a conexão SSH no GitHub (chave pública, ...): http://help.github.com/ssh-issues/
- Mencionar alguém em um
pull requestouissue: https://github.com/blog/1004-mention-autocompletion