- Website: https://kubernetes.io/docs
- Repositório: kubernetes/website
- Papéis dentro da comunidade: https://github.com/kubernetes/community/blob/master/community-membership.md
- Orientações sobre abertura de PR: https://kubernetes.io/docs/contribute/new-content/open-a-pr/
- Guia geral sobre contribuições (em inglês): https://www.kubernetes.dev/docs/contributor-cheatsheet/
- A documentaçãoé escrita em markdown (
.md
) e o build feito com GoHugo
- Slack do k8s: https://slack.k8s.io/
- Canal de documentação ptbr no slack:
#kubernetes-docs-pt
- Assinar o CLA: https://github.com/kubernetes/community/blob/master/CLA.md
.
├── CONTRIBUTING.md
├── Dockerfile
├── LICENSE
...
├── content
│ ├── en
│ ...
│ └── pt-br -> Documentação em Português aqui!
...
- Escolher página para traduzir
- Atribuir na planilha com o seu usuário do github
- Fazer o fork do projeto
- Criar a branch para tradução e traduzir
- (opcional) build e teste na máquina local
- quando você abre um pull request é gerado um preview no Netlify, então não necessariamente precisa executar na sua máquina
- Criar o pull request
- (opcional mas recomendado) Enviar o pull request no slack
-
Planilha usada para rastreio das páginas e traduções:
https://docs.google.com/spreadsheets/d/1HiaVFJ7nRZo1MPNNYyq1u-L_N9xrJvzuUzkZ3GuJGNU/edit#gid=1462985556 -
Guia de contribuição: https://github.com/kubernetes/community/blob/master/contributors/guide/contributor-cheatsheet/README-pt.md
-
Guia de como usar o repositório de documentação (como clonar, executar...):
https://github.com/kubernetes/website/blob/main/README-pt.md -
Guia de estilo para tradução/criação da documentação (atualmente, sem tradução):
https://kubernetes.io/docs/contribute/style/style-guide/
Não se tem uma regra quanto a isso, contanto que seja algo descritivo pra você, tá valendo :)
Não se tem uma regra formal sobre isso também, na issue de tracking tem uma orientação sobre algo como:
[Add | Update] <path do arquivo>
, mas se não usar não é problema, o bot vai cuidar de adicionar as labels referente ao português :)
É preferível abrir um PR por página (em alguns casos a página tem dependências de arquivos e exemplos e tals, então faz parte da página), isso ajuda bastante quem está fazendo a revisão :)
No! pode mandar no canal do slack que alguém vai ver e vai sugerir algo, não precisa esperar só a revisão do PR depois de aberto :)
É importante lembrar que as pessoas revisoras são voluntárias que fazem isso no tempo livre, então infelizmente isso pode acontecer, o que você pode fazer é, caso demore assim, mande o PR no canal do slack e pergunte se alguém pode ajudar, ou chamar diretamente a pessoa que está atribuida como revisora no slack e perguntar se ela pode dar uma força :)