Skip to content

Update Portuguese translation of Namespace documentation to include missing sections from the English version #51288

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

Saldanhaa7
Copy link

Update Portuguese "Namespaces" documentation to match English source content

This pull request updates the Portuguese translation of the Namespaces documentation to bring it in line with the current English version. The previous translation was missing several important sections and conceptual explanations that have been added to the English page over time.

🔍 Improvements included:

  • Addition of the “When to Use Multiple Namespaces” section, including a note about avoiding the use of the default namespace in production environments
  • Inclusion of the “Initial namespaces” section describing the four default namespaces (default, kube-system, kube-public, kube-node-lease)
  • Addition of the warning block about conflicts between namespace names and public top-level domains (TLDs)
  • Updated links to reference correct and up-to-date pages (e.g., replacing outdated references to Lease objects, correcting glossary and concept links)

✅ Purpose

Ensure that Portuguese-speaking users have access to the same up-to-date, accurate, and complete documentation available in English, improving the overall consistency and quality of Kubernetes internationalization.

…ects/namespaces.md`

Signed-off-by: saldanha <bruno14042003@gmail.com>
Copy link

linux-foundation-easycla bot commented Jun 17, 2025

CLA Signed


The committers listed above are authorized under a signed CLA.

@k8s-ci-robot k8s-ci-robot added the cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. label Jun 17, 2025
@k8s-ci-robot
Copy link
Contributor

Welcome @Saldanhaa7!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign jcjesus for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added area/localization General issues or PRs related to localization language/pt Issues or PRs related to Portuguese language size/M Denotes a PR that changes 30-99 lines, ignoring generated files. sig/docs Categorizes an issue or PR as relevant to SIG Docs. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. and removed cncf-cla: no Indicates the PR's author has not signed the CNCF CLA. labels Jun 17, 2025
Copy link

netlify bot commented Jun 17, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 88797d8
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/685178407227a00008c58cf4
😎 Deploy Preview https://deploy-preview-51288--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@Saldanhaa7
Copy link
Author

/cc @stormqueen1990

Copy link
Member

@stormqueen1990 stormqueen1990 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Olá, @Saldanhaa7! Bem-vindo à documentação em português do Kubernetes!

Primeiramente, muito obrigada pelas correções. Acredito que essa seja a tua primeira contribuição. Temos um guia da pessoa contribuidora da localização com informações úteis para essa e para as tuas futuras contribuições: https://kubernetes.io/pt-br/docs/contribute/localization_pt-br/

Essa alteração está bem encaminhada, encontrei apenas alguns detalhes que precisam ser ajustados. Observei também que algumas alterações da página em inglês no front matter e no primeiro parágrafo ainda não estão presentes, e seria bom que adicionássemos neste PR.

Caso precise de ajuda para verificar estes pontos, podes entrar em contato conosco através do Slack do Kubernetes, no canal #kubernetes-docs-pt. Da mesma forma, se tiveres quaisquer dúvidas ou discordâncias com relação a essa revisão, peço que envies uma mensagem no Slack para que possamos discutir.

O Kubernetes é inicializado com quatro namespaces:

`default`
: O namespace padrão para objetos sem namespace
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Este parágrafo possui mais texto na documentação em inglês que precisa ser incluído aqui também.

: Este namespace contém os objetos de [Lease](/docs/concepts/architecture/leases/) associados com cada node. Node leases permitem que o kubelet envie [heartbeats](/docs/concepts/architecture/nodes/#node-heartbeats) para que a camada de gerenciamento detecte falhas nos nodes.

`kube-public`
: Este namespace é criado automaticamente e é legível por todos os usuários (incluindo usuários não autenticados). Este namespace é reservado principalmente para uso do cluster, no caso de alguns recursos que precisem ser visíveis e legíveis publicamente por todo o cluster. O aspecto público deste namespace é apenas uma convenção, não um requisito.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ajuste pequeno de grifo e de terminologia, conforme o que temos na documentação em inglês:

Suggested change
: Este namespace é criado automaticamente e é legível por todos os usuários (incluindo usuários não autenticados). Este namespace é reservado principalmente para uso do cluster, no caso de alguns recursos que precisem ser visíveis e legíveis publicamente por todo o cluster. O aspecto público deste namespace é apenas uma convenção, não um requisito.
: Este namespace é criado automaticamente e é legível por _todos_ os clientes (incluindo clientes não autenticados). Este namespace é reservado principalmente para uso do cluster, no caso de alguns recursos que precisem ser visíveis e legíveis publicamente por todo o cluster. O aspecto público deste namespace é apenas uma convenção, não um requisito.

Nomes de namespaces devem ser válidos conforme a [RFC 1123 para rótulos DNS](/docs/concepts/overview/working-with-objects/names/#dns-label-names).

{{< warning >}}
Ao criar namespaces com o mesmo nome de [domínios de topo públicos (TLDs)](https://data.iana.org/TLD/tlds-alpha-by-domain.txt), os *Services* dentro desses namespaces podem ter nomes DNS curtos que colidem com registros DNS públicos. Com isso, _workloads_ de qualquer namespace que realizem consultas DNS sem um [ponto final (trailing dot)](https://datatracker.ietf.org/doc/html/rfc1034#page-8) podem ser redirecionadas para esses serviços, tendo precedência sobre o DNS público.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Alguns pontos aqui:

  • Não precisamos grifar Service, já que se trata de objeto da API do Kubernetes.
  • Podemos usar o termo carga de trabalho como tradução de workload (temos este termo definido como padrão no dicionário de termos da localização).
Suggested change
Ao criar namespaces com o mesmo nome de [domínios de topo públicos (TLDs)](https://data.iana.org/TLD/tlds-alpha-by-domain.txt), os *Services* dentro desses namespaces podem ter nomes DNS curtos que colidem com registros DNS públicos. Com isso, _workloads_ de qualquer namespace que realizem consultas DNS sem um [ponto final (trailing dot)](https://datatracker.ietf.org/doc/html/rfc1034#page-8) podem ser redirecionadas para esses serviços, tendo precedência sobre o DNS público.
Ao criar namespaces com o mesmo nome de [domínios de topo públicos (TLDs)](https://data.iana.org/TLD/tlds-alpha-by-domain.txt), os Services dentro desses namespaces podem ter nomes DNS curtos que colidem com registros DNS públicos. Com isso, cargas de trabalho de qualquer namespace que realizem consultas DNS sem um [ponto final (trailing dot)](https://datatracker.ietf.org/doc/html/rfc1034#page-8) podem ser redirecionadas para esses serviços, tendo precedência sobre o DNS público.

Comment on lines 119 to 120
A camada de gerenciamento Kubernetes configura um {{< glossary_tooltip text="label" term_id="label" >}} imutável `kubernetes.io/metadata.name` em todos os namespaces se a
[feature gate](/docs/reference/command-line-tools-reference/feature-gates/)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Esse parágrafo precisa ser atualizado, já que o feature gate não é mais necessário.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/pt Issues or PRs related to Portuguese language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants