Roteiro web
Para iniciar com sua contribuição ao manual utilizando a interface web do GitHub, basta seguir esses passos:
As funcionalidades ocorrem dentro de uma conta do GitHub. Faça o login ou cadastre-se.
Vá até a página principal da tradução e clique em Fork, acima e à direita da página. Isso irá criar uma cópia do repositório sob seu total controle.
Localize o arquivo que deseja alterar a partir da página de códigos fonte, clique no nome do arquivo, e na nova página clique no botão de alterar (com ícone de um lápis inclinado).
Caso esteja editando o arquivo a partir da listagem de arquivos desatualizados, é importante alterar a tag de revisão e preencher o campo Status: com o hash do arquivo em inglês dessa listagem.
No GitHub da tradução existem só os arquivos já traduzidos. Para acrescentar um novo arquivo, basta clicar em Add file > Create new file. Será aberta uma tela para informar o caminho completo e o nome do novo arquivo, que deve ser idêntico ao arquivo original.
Para criar um arquivo dentro de um diretório novo, basta informar o caminho completo do arquivo, com os nomes de diretórios separados por barra normal (/), que a interface fará a criação automaticamente.
Quanto terminar as alterações não se esqueça de criar uma tag de revisão e salvar suas alterações!
Para enviar as suas modificações:
- Navegue até a página
Codede seu fork, e clique emContributee depois emOpen pull request.
Na nova página, revise o conjunto de alterações abaixo, e caso esteja satisfeito clique em Create pull request.
Pronto. Suas alterações foram encaminhadas ao repositório oficial. Você pode acompanhar a aplicação dos seus pull requests através da página https://github.com/php/doc-pt_br/pulls.
O que fazer agora? Agora é esperar a discussão e eventual aprovação do seu PR. Enquanto isso estude as Prioridades para planejar sua próxima contribuição!
Após o merge do pull request no repositório oficial, o seu fork ficará desatualizado. Isso significa que na sua próxima contribuição, o PR pode dar alguns problemas. Para evitar isso, é preciso sincronizar o seu fork após o aceite do pull request, ou antes de enviar o seu próximo PR.
Vá na página do do seu fork, e na aba Code deve aparecer uma mensagem mais ou menos assim:
Na mesma linha, é possível encontrar um link chamado Sync fork. Basta clicar aqui e clicar em Update branch, conforme as imagens a seguir:
Tenha algum cuidado com as opções Discard, que elas efetivamente apagam alguma alteração que você tenha feito localmente, sem considerar se as mesmas estão ou não no repositório oficial.