Roteiro web

Para iniciar com sua contribuição ao manual utilizando a interface web do GitHub, basta seguir esses passos:

Cadastro ou login no Github

As funcionalidades ocorrem dentro de uma conta do GitHub. Faça o login ou cadastre-se.

Fork no projeto de tradução

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.

Editar os arquivos

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).

Arquivos não traduzidos

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 gravar!

Enviar modificações

Para enviar as suas modificações:

1. Navegue até a página Code de seu fork, e clique em Contribute e depois em Open 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? Trabalhar na próxima alteração!

Importante: É preciso sincronizar seu fork de quando em quanto. Isso é importante no caso de for começar uma nova tradução e seu fork estiver atrás do repositório oficial. Isso é indicado no seu repositório quando aparece a seguinte mensagem na aba Code:

Na mesma linha da mensagem, é possível encontrar a opção Sync fork. Basta clicar aqui e seguir as opções para sincronizar o seu fork.

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.