-
Notifications
You must be signed in to change notification settings - Fork 101
Home
Olá, e seja bem vindo!
Caso tenha encontrado algum problema na tradução ou queira mexer em um arquivo desatualizado, você pode realizar alterações diretamente do seu navegador, aqui pelo GitHub (ver roteiro web), ou através da edição de arquivos locais (ver roteiro git). Ao final, temos algumas explicações em vídeo que podem ajudar a visualizar esses processos.
O manual do PHP é extenso e complexo. Para entender a estrutura e convenções utilizadas, há o longo e detalhado guia de edição do manual, material básico para quem quiser trabalhar mais ativamente na tradução.
As discussões ocorrem via issues aqui ou através da lista de discussão oficial.
Os arquivos desatualizados são prioridade, e podem ser conferidos na situação atual. Ao traduzir um arquivo, é importante também atualizar a tag de revisão.
Há várias maneiras de contribuir com o manual, a saber:
-
Realizar traduções diretamente pelo seu navegador, como descrito no roteiro web;
-
Realizar traduções a partir arquivos baixados localmente, com mais ferramentas (estatísticas, compilação, detecção de erros), conforme descrito no roteiro git.
Estas opções estão listadas em ordem de facilidade. A primeira opção permite realizar traduções direto do navegador mas não fornece ferramental de verificação. A opção em linha de comando exige maior conhecimento e instalação local, sendo mais facilmente montado e mantido em ambientes Linux. Apesar da complicação a mais é o necessário para trabalhar ma tradução com maior frequência.
Esses roteiros focam nos procedimentos em si, mas não explicam detalhes de estrutura e padrões adotados no Manual do PHP e suas traduções, que são detalhados no guia de edição do manual.
A contribuição de correções, atualizações e mesmo novas traduções não dependem de acesso específico no repositório GitHub. O procedimento para conseguir o acesso direto, aliás, é realizar modificações através issues ou pull requests. O acesso pode ser solicitado depois de alguns meses de envios contínuos.
Para facilitar o entendimento, veja também uma explicação em vídeo desses passos. Infelizmente o vídeo pula o passo de alterar a tag de revisão.