Issues e perguntas frequentes

Encontrei um arquivo desatualizado, parcialmente traduzido ou errado

Essa era uma situação comum na tradução do manual para Português do Brasil, mas felizmente resolvida (como pode ser observado na situação atual).

Mas antes de abrir um issue, verifique se o arquivo em questão já não está na lista de arquivos desatualizados, na lista de arquivos sem revtag ou na lista de arquivos não traduzidos. Issues abertos para esses arquivos serão fechados, por serem situações já mapeadas.

Algumas páginas do manual parecem estar parcialmente traduzidas. Isso ocorre porque o compilador do manual traduz algumas palavras automaticamente, como cabeçalhos de tabelas e títulos de seções. Esses casos estão incluídos nas listagens acima, e também terão os issues fechados, pela mesma razão acima.

No entanto, erros de tradução, ou erros materiais em exemplos devem ter issues abertos, pois são questões ainda não mapeadas.

Posso contribuir sem ser participante do projeto?

Sim! Não é necessário participar do projeto PHP diretamente para para começar a contribuir, e basta ter um usuário no GitHub. Veja alguns roteiros para lhe guiar no processo, caso não conheça o fluxo de trabalho git ou GitHub:

• Roteiro web
• Roteiro git

Suas contribuições, enviadas como pull requests ou issues são revisadas e depois oficializadas por colaboradores que já possuam credenciais nos repositórios oficiais.

Enviei meu pull request. Em quanto tempo minha contribuição estará disponível?

Seus arquivos passarão por revisão. A documentação é gigante e prima pela qualidade das informações ali contidas. Para tal precisamos cuidar quais traduções devem ir para a documentação oficial.

Isso não quer dizer que seus pull requests não serão aceitos. Nos comentários do seu PR avisaremos onde achamos que você poderia melhorar, e após modificado, aceito e encaminhado ao repositório oficial.

Meu pull request foi aceito. Em quanto tempo minhas modificações estarão disponíveis?

O aceite do PR ocorre junto com o encaminhamento das alterações ao repositório oficial. As alterações não aparecem imediatamente no manual online, no entanto. O manual é compilado e espelhado uma vez por dia, então suas alterações podem levar até uns dois dias para aparecerem publicadas nos sites. O espelho oficial compila a cada seis horas. Mais detalhes aqui.