website icon indicating copy to clipboard operation
website copied to clipboard

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

Open stormqueen1990 opened this issue 1 year ago • 12 comments

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

stormqueen1990 avatar Sep 19 '24 15:09 stormqueen1990

@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:

  • Why are we solving this issue?
  • To address this issue, are there any code changes? If there are code changes, what needs to be done in the code and what places can the assignee treat as reference points?
  • Does this issue have zero to low barrier of entry?
  • How can the assignee reach out to you for help?

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:

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. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

k8s-ci-robot avatar Sep 19 '24 15:09 k8s-ci-robot

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

stormqueen1990 avatar Sep 19 '24 15:09 stormqueen1990

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

moreirayokoyama avatar Sep 20 '24 12:09 moreirayokoyama

@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:

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. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

k8s-ci-robot avatar Sep 20 '24 12:09 k8s-ci-robot

/assign @moreirayokoyama

moreirayokoyama avatar Sep 20 '24 12:09 moreirayokoyama

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.

stormqueen1990 avatar Sep 20 '24 18:09 stormqueen1990

@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 avatar Sep 20 '24 18:09 moreirayokoyama

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.

sftim avatar Sep 21 '24 16:09 sftim

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?

moreirayokoyama avatar Sep 22 '24 11:09 moreirayokoyama

@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.

sftim avatar Sep 22 '24 11:09 sftim

@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 avatar Sep 22 '24 12:09 moreirayokoyama

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.

moreirayokoyama avatar Sep 22 '24 12:09 moreirayokoyama

@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.

stormqueen1990 avatar Sep 24 '24 19:09 stormqueen1990

I can help with this task

jhonmike avatar Jul 01 '25 02:07 jhonmike

/assign

jhonmike avatar Jul 01 '25 02:07 jhonmike