Skip to content

Commit 508a901

Browse files
authored
Merge pull request #39039 from stormqueen1990/feat/add-content-guide
[pt-br] Add docs/contribute/style/content-guide.md
2 parents 74b0973 + b3dcbbc commit 508a901

File tree

1 file changed

+83
-0
lines changed

1 file changed

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

Comments
 (0)