|
| 1 | +--- |
| 2 | +title: Contribuir com a documentação do Kubernetes em Português Brasileiro |
| 3 | +content_type: concept |
| 4 | +--- |
| 5 | + |
| 6 | +Olá! |
| 7 | + |
| 8 | +Esta página contém informações sobre o processo de localização em português (Brasil), desde o processo de contribuição até um dicionário de temos com as respectivas traduções. |
| 9 | + |
| 10 | + |
| 11 | +## Passo a passo para contribuição |
| 12 | + |
| 13 | +1. Escolha uma página que deseja localizar. |
| 14 | +2. Verifique se já existe uma issue no repositório ([kubernetes/website]) aberta para a página que escolheu. |
| 15 | +3. Faça o fork do repositório [kubernetes/website]. |
| 16 | +4. Crie uma branch no seu fork e faça a localização da página. |
| 17 | +5. Execute o check de links quebrados (os detalhes de como executar estão nessa página). |
| 18 | +7. Abra o Pull Request. Caso ainda não tenha assinado o [CLA](https://github.com/kubernetes/community/blob/master/CLA.md), haverá instruções no Pull Request. |
| 19 | +8. Verifique se as checagens no Pull Requests não estão quebradas e se foi gerado um preview da sua localização. |
| 20 | +9. Por fim, recomendamos que envie o pull request no canal do slack do time [`#kubernetes-docs-pt`]. |
| 21 | + |
| 22 | + |
| 23 | +## Checagem de links quebrados |
| 24 | +Para garantir que os links referenciados na página que localizou não estão quebrados, você pode executar um script de checagem de links quebrados. |
| 25 | +Dentro do seu fork local do repositório, executar: |
| 26 | + |
| 27 | +```bash |
| 28 | +scripts/linkchecker.py -f content/pt-br/<caminho-da-pagina> |
| 29 | +``` |
| 30 | + |
| 31 | +Onde, |
| 32 | +* `content/pt-br/<caminho-da-pagina>` é o caminho da página que está localizando |
| 33 | + |
| 34 | + |
| 35 | +## Dicionário de termos com tradução |
| 36 | + |
| 37 | +| Inglês | Português | Comentários | |
| 38 | +| ---------------------- | ---------------------- | ----------------------- | |
| 39 | +| addon | complemento | | |
| 40 | +| API call | chamada para a API | | |
| 41 | +| API server | servidor de API | | |
| 42 | +| backward compatibility | retrocompatibilidade | | |
| 43 | +| builtin | embutido | | |
| 44 | +| container image | imagem do contêiner | | |
| 45 | +| dashboard | painel | | |
| 46 | +| data plane | camada de dados | | |
| 47 | +| control plane | camada de gerenciamento | | |
| 48 | +| workload | carga de trabalho | | |
| 49 | +| workflow | fluxo de execução | | |
| 50 | + |
| 51 | + |
| 52 | +## Dicionário de termos não traduzidos |
| 53 | + |
| 54 | +| Inglês | Comentários | |
| 55 | +| ---------------------- | ----------------------- | |
| 56 | +| addon manager | | |
| 57 | +| auto-scaling | | |
| 58 | +| bind | | |
| 59 | +| cloud native | | |
| 60 | +| controller manager | | |
| 61 | +| deploy | | |
| 62 | +| service mesh | | |
| 63 | +| release | | |
| 64 | +| proxy | | |
| 65 | +| endpoint | | |
| 66 | + |
| 67 | +Nomes de objetos do Kubernetes permanecem no original com a primeira letra em maiúsculo, por exemplo: |
| 68 | +* Pod |
| 69 | +* Service |
| 70 | +* Deployment |
| 71 | + |
| 72 | +entre outros. |
| 73 | + |
| 74 | + |
| 75 | + |
| 76 | +## Perguntas frequentes |
| 77 | + |
| 78 | +### Qual título devo usar quando abrir o Pull Request? |
| 79 | +Recomendamos usar o formato `[pt-br] Update/Add <caminho do arquivo>`. |
| 80 | + |
| 81 | +### Posso abrir um Pull Request traduzindo mais de uma página de documentação? |
| 82 | +Sempre dê preferência por abrir um Pull Request por página, dessa forma facilita a revisão e o acompanhamento do trabalho. |
| 83 | + |
| 84 | +### Tenho dúvidas nos termos, preciso abrir o Pull Request e esperar alguém revisar? |
| 85 | +Não, pode mandar a dúvida no canal do slack ([`#kubernetes-docs-pt`]) que vamos ajudar com a dúvida. |
| 86 | + |
| 87 | +### Abri um Pull Request mas ainda não teve revisão, o que fazer? |
| 88 | +É importante lembrar que as pessoas revisoras são voluntárias, então em alguns casos pode demorar um pouco. O que recomendamos nesses casos é enviar uma mensagem no canal do slack com o link do Pull Request, assim podemos verificar o que pode ter acontecido. |
| 89 | + |
| 90 | + |
| 91 | + |
| 92 | +Ficou alguma dúvida que não foi respondida nessa página? |
| 93 | +Fale com a gente canal no slack do Kubernetes [`#kubernetes-docs-pt`]. |
| 94 | + |
| 95 | +[`#kubernetes-docs-pt`]: https://kubernetes.slack.com/messages/kubernetes-docs-pt |
| 96 | +[kubernetes/website]: https://github.com/kubernetes/website |
0 commit comments