|
| 1 | +--- |
| 2 | +title: Guia de Conteúdo da Documentação |
| 3 | +linktitle: Guia de conteúdo |
| 4 | +content_type: concept |
| 5 | +weight: 10 |
| 6 | +--- |
| 7 | + |
| 8 | +<!-- overview --> |
| 9 | + |
| 10 | +Esta página contém orientações para a documentação do Kubernetes. |
| 11 | + |
| 12 | +Se você tiver dúvidas sobre o que é permitido, junte-se ao canal #sig-docs no |
| 13 | +[Slack do Kubernetes](https://slack.k8s.io/) e pergunte! |
| 14 | + |
| 15 | +Você pode se registrar no Slack do Kubernetes através do endereço https://slack.k8s.io/. |
| 16 | + |
| 17 | +Para informações sobre como criar novo conteúdo para a documentação do Kubernetes, |
| 18 | +siga o [guia de estilo](/pt-br/docs/contribute/style/style-guide). |
| 19 | + |
| 20 | +<!-- body --> |
| 21 | + |
| 22 | +## Visão geral |
| 23 | + |
| 24 | +O código-fonte para o _website_ do Kubernetes, incluindo a documentação, é |
| 25 | +armazenado no repositório [kubernetes/website](https://github.com/kubernetes/website). |
| 26 | + |
| 27 | +Localizada dentro da pasta `kubernetes/website/content/<codigo-do-idioma>/docs`, |
| 28 | +a maior parte da documentação do Kubernetes é específica para o |
| 29 | +[projeto Kubernetes](https://github.com/kubernetes/kubernetes). |
| 30 | + |
| 31 | +## O que é permitido |
| 32 | + |
| 33 | +A documentação do Kubernetes permite conteúdo de projetos de terceiros somente |
| 34 | +quando: |
| 35 | + |
| 36 | +- O conteúdo documenta software que existe no projeto Kubernetes |
| 37 | +- O conteúdo documenta software que está fora do projeto, mas é necessário para |
| 38 | + o funcionamento do Kubernetes |
| 39 | +- O conteúdo é canônico no kubernetes.io, ou está vinculado a conteúdo canônico |
| 40 | + em outro local |
| 41 | + |
| 42 | +### Conteúdo de terceiros |
| 43 | + |
| 44 | +A documentação do Kubernetes contém exemplos aplicados de projetos no projeto |
| 45 | +Kubernetes — projetos que existem nas organizações |
| 46 | +[kubernetes](https://github.com/kubernetes) e |
| 47 | +[kubernetes-sigs](https://github.com/kubernetes-sigs) |
| 48 | +do GitHub. |
| 49 | + |
| 50 | +Links para conteúdo ativo no projeto Kubernetes sempre são permitidos. |
| 51 | + |
| 52 | +O Kubernetes requer alguns conteúdos de terceiros para funcionar. Exemplos |
| 53 | +incluem agentes de execução de contêiner (containerd, CRI-O, Docker), |
| 54 | +[políticas de rede](/pt-br/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/) |
| 55 | +(plugins CNI), [controladores Ingress](/docs/concepts/services-networking/ingress-controllers/), |
| 56 | +e [sistemas de log](/pt-br/docs/concepts/cluster-administration/logging/). |
| 57 | + |
| 58 | +A documentação pode conter vínculos com software de código aberto de terceiros |
| 59 | +fora do projeto Kubernetes somente quando estes projetos são necessários para |
| 60 | +o funcionamento do Kubernetes. |
| 61 | + |
| 62 | +### Conteúdo duplicado |
| 63 | + |
| 64 | +Sempre que possível, a documentação do Kubernetes utiliza links para fontes |
| 65 | +canônicas de documentação ao invés de hospedar conteúdo duplicado. |
| 66 | + |
| 67 | +Conteúdo duplicado requer o dobro de esforço (ou mais!) para manter e fica |
| 68 | +obsoleto mais rapidamente. |
| 69 | + |
| 70 | +{{< note >}} |
| 71 | +Se você é um mantenedor e precisa de auxílio para hospedar sua própria |
| 72 | +documentação, solicite ajuda no canal |
| 73 | +[#sig-docs do Slack do Kubernetes](https://kubernetes.slack.com/messages/C1J0BPD2M/). |
| 74 | +{{< /note >}} |
| 75 | + |
| 76 | +### Mais informações |
| 77 | + |
| 78 | +Se você tem dúvidas sobre o conteúdo permitido, junte-se ao canal #sig-docs |
| 79 | +do [Slack do Kubernetes](https://slack.k8s.io/) e faça sua pergunta! |
| 80 | + |
| 81 | +## {{% heading "whatsnext" %}} |
| 82 | + |
| 83 | +* Leia o [guia de estilo](/pt-br/docs/contribute/style/style-guide). |
0 commit comments