kubernetes / website

Kubernetes website and documentation repo:
https://kubernetes.io
Creative Commons Attribution 4.0 International
4.5k stars 14.43k forks source link

[pt-br] Page "Arquitetura do Kubernetes" is outdated #48002

Open stormqueen1990 opened 1 month ago

stormqueen1990 commented 1 month ago

The page describing the Kubernetes cluster architecture in the Brazilian Portuguese localization is severely outdated. The contents of this page in English currently contains a description of each of the components and diagrams that are not present in the Brazilian Portuguese version. It must be synchronized with the current English version.

Page location in project: content/pt-br/docs/concepts/architecture/_index.md Page address in website: https://kubernetes.io/pt-br/docs/concepts/architecture/ Brazilian Portuguese documentation for contributors: https://kubernetes.io/pt-br/docs/contribute/localization_pt-br/


A página que descreve a arquitetura do cluster do Kubernetes na documentação em Português Brasileiro está bastante desatualizada. O conteúdo atual desta página em inglês contém descrições por componente e diagramas que não encontram-se presentes na versão em português brasileiro. Esta página deve ser atualizada para estar em dia com o conteúdo em inglês.

Localização da página no projeto: content/pt-br/docs/concepts/architecture/_index.md Endereço da página no website: https://kubernetes.io/pt-br/docs/concepts/architecture/ Documentação para o contribuidor: https://kubernetes.io/pt-br/docs/contribute/localization_pt-br/

/language pt /triage accepted /area localization /help

k8s-ci-robot commented 1 month ago

@stormqueen1990: This request has been marked as needing help from a contributor.

Guidelines

Please ensure that the issue body includes answers to the following questions:

For more details on the requirements of such an issue, please see here and ensure that they are met.

If this request no longer meets these requirements, the label can be removed by commenting with the /remove-help command.

In response to [this](https://github.com/kubernetes/website/issues/48002): >The page describing the Kubernetes cluster architecture in the Brazilian Portuguese localization is severely outdated. The contents of this page in English currently contains a description of each of the components and diagrams that are not present in the Brazilian Portuguese version. It must be synchronized with the current English version. > >Page location in project: `content/pt-br/docs/concepts/architecture/_index.md` >Page address in website: https://kubernetes.io/pt-br/docs/concepts/architecture/ >Brazilian Portuguese documentation for contributors: https://kubernetes.io/pt-br/docs/contribute/localization_pt-br/ > >--- > >A página que descreve a arquitetura do cluster do Kubernetes na documentação em Português Brasileiro está bastante desatualizada. O conteúdo atual desta página em inglês contém descrições por componente e diagramas que não encontram-se presentes na versão em português brasileiro. Esta página deve ser atualizada para estar em dia com o conteúdo em inglês. > >Localização da página no projeto: `content/pt-br/docs/concepts/architecture/_index.md` >Endereço da página no website: https://kubernetes.io/pt-br/docs/concepts/architecture/ >Documentação para o contribuidor: https://kubernetes.io/pt-br/docs/contribute/localization_pt-br/ > >/language pt >/triage accepted >/area localization >/help Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
stormqueen1990 commented 1 month ago

Once this issue is addressed, we can merge PR #47945

moreirayokoyama commented 1 month ago

Hi @stormqueen1990. As I'm beginning to contribute, I'm willing to help updating the Brazilian Portuguese docs as much as I can, and I'm willing to help with this one.

/assign @moreirayokoyama

k8s-ci-robot commented 1 month ago

@moreirayokoyama: GitHub didn't allow me to assign the following users: me.

Note that only kubernetes members with read permissions, repo collaborators and people who have commented on this issue/PR can be assigned. Additionally, issues/PRs can only have 10 assignees at the same time. For more information please see the contributor guide

In response to [this](https://github.com/kubernetes/website/issues/48002#issuecomment-2363567834): >Hi @stormqueen1990. As I'm beginning to contribute, I'm willing to help updating the Brazilian Portuguese docs as much as I can, and I'm willing to help with this one. > >/assign me Instructions for interacting with me using PR comments are available [here](https://git.k8s.io/community/contributors/guide/pull-requests.md). If you have questions or suggestions related to my behavior, please file an issue against the [kubernetes-sigs/prow](https://github.com/kubernetes-sigs/prow/issues/new?title=Prow%20issue:) repository.
moreirayokoyama commented 1 month ago

/assign @moreirayokoyama

stormqueen1990 commented 1 month ago

Hi @stormqueen1990. As I'm beginning to contribute, I'm willing to help updating the Brazilian Portuguese docs as much as I can, and I'm willing to help with this one.

Hi @moreirayokoyama! You should be able to assign yourself as long as you have previously commented on the issue.

moreirayokoyama commented 1 month ago

@stormqueen1990 o termo: cloud-controller-manager está no glossário traduzido como Gerenciador de controle de nuvem, apesar de, no mesmo glossário, a palavra controller constar como controlador que eu entendo como sendo a mais correta. O que você acha? Posso usar Gerenciador de Controlador de Nuvem na documentação (e fazer a devida correção no Glossário) ou mantenho como está?

sftim commented 1 month ago

As well as https://kubernetes.io/docs/concepts/architecture/, look at the updates to https://kubernetes.io/docs/concepts/overview/components/ that have been made since the Portuguese page was updated.

moreirayokoyama commented 1 month ago

As well as https://kubernetes.io/docs/concepts/architecture/, look at the updates to https://kubernetes.io/docs/concepts/overview/components/ that have been made since the Portuguese page was updated.

I'm on it. Should I convert the PR to draft and make it a single task? Or treat this like a separate task?

sftim commented 1 month ago

@moreirayokoyama my hint is more that you can copy some of the existing Portuguese text rather than making a new translation. Some of the English text was moved rather than removed.

moreirayokoyama commented 1 month ago

@sftim for this issue (the Kubernetes Architecture page) I didn't find any existing Portuguese text. Maybe I'm searching it wrong? For the Kubernetes Components page you mentioned, I did noticed an existing Portuguese text, and I'll work it the way you're suggesting. I did something similar for #47748. But I'll pay more attention for moved text as well. Thanks.

moreirayokoyama commented 1 month ago

Now that I'm reading the Portuguese version of the Components Overview page, I think I get what you meant, @sftim. Most of it seems pretty much what I did for the Cluster Architecture page, and it would be easier to just move it and make some minor updates. I'll pay more attention in the future.

stormqueen1990 commented 1 month ago

@stormqueen1990 o termo: cloud-controller-manager está no glossário traduzido como Gerenciador de controle de nuvem, apesar de, no mesmo glossário, a palavra controller constar como controlador que eu entendo como sendo a mais correta. O que você acha? Posso usar Gerenciador de Controlador de Nuvem na documentação (e fazer a devida correção no Glossário) ou mantenho como está?

@moreirayokoyama poderias trazer essa discussão para o canal #kubernetes-docs-pt do Slack do Kubernetes? Temos preferência por discutir terminologias por lá para que mais contribuidores consigam participar da discussão de uma forma mais imediata.