Skip to content

Commit dbc2743

Browse files
[pt-br] Add pt-BR localization contributor guide (#44662)
* feat: add localization_pt-br * feat: add localization_pt-br * feat: add more terms * feat: add untranslated terms * feat: add more details * feat: reorder dict and add more info * feat: add more info * feat: add faq * feat: improve format * Update content/pt-br/docs/contribute/localization_pt-br.md Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com> * Apply suggestions from code review Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com> --------- Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com>
1 parent 15bb374 commit dbc2743

File tree

1 file changed

+96
-0
lines changed

1 file changed

+96
-0
lines changed
Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
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

Comments
 (0)