|
1 | 1 | ---
|
2 | 2 | content_type: concept
|
3 |
| -title: Contribua com o Kubernetes docs |
4 |
| -linktitle: Contribute |
| 3 | +title: Contribua com a documentação do Kubernetes |
| 4 | +linktitle: Contribuir |
5 | 5 | main_menu: true
|
6 | 6 | weight: 80
|
| 7 | +no_list: true |
| 8 | +card: |
| 9 | + name: contribuir |
| 10 | + weight: 10 |
| 11 | + title: Comece a contribuir para o K8s |
| 12 | +--- |
7 | 13 | ---
|
8 | 14 |
|
9 | 15 | <!-- overview -->
|
10 | 16 |
|
11 |
| -Caso você gostaria de contribuir com a documentação ou o site do Kubernetes, |
12 |
| -ficamos felizes em ter sua ajuda! Qualquer pessoa pode contribuir, seja você novo no |
13 |
| -projeto ou se você já esta no mercado há muito tempo. Além disso, Se você se identifica como |
14 |
| -desenvolvedor, usuário final ou alguém que simplesmente não suporta ver erros de digitação. |
| 17 | +*O Kubernetes agradece as melhorias de todos os contribuidores, novos e experientes!* |
| 18 | + |
| 19 | +{{< note >}} |
| 20 | +Para saber mais sobre como contribuir o Kubernetes em geral, veja a |
| 21 | +[documentação para contribuidor](https://www.kubernetes.dev/docs/). |
| 22 | +{{< /note >}} |
| 23 | + |
| 24 | +Este site é mantido pelo [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs). |
15 | 25 |
|
| 26 | +Contribuidores da documentação do Kubernetes podem: |
| 27 | + - Melhorar o conteúdo existente |
| 28 | + - Criar novo conteúdo |
| 29 | + - Traduzir a documentação |
| 30 | + - Gerenciar e publicar a documentação como parte do ciclo de lançamento do Kubernetes |
16 | 31 |
|
17 | 32 | <!-- body -->
|
18 | 33 |
|
19 | 34 | ## Começando
|
20 | 35 |
|
21 |
| -Qualquer pessoa pode abrir uma issue descrevendo o problema ou melhorias desejadas com a documentação ou contribuir com uma alteração e uma solicitação de mudança (Pull Request - PR). |
22 |
| -Algumas tarefas exigem mais confiança e precisam de mais acesso na organização Kubernetes. |
23 |
| -Veja [Participando do SIG Docs](/docs/contribute/participating/) para mais detalhes sobre |
24 |
| -as funções e permissões. |
25 |
| - |
26 |
| -A documentação do Kubernetes reside em um repositório do GitHub. Nós damos as boas-vindas |
27 |
| -a todas as contribuições, mas você vai precisa estar familiarizado com o uso básico de git e GitHub para |
28 |
| -operar efetivamente na comunidade Kubernetes. |
| 36 | +Qualquer pessoa pode abrir uma issue sobre a documentação, ou contribuir com uma mudança por meio de um pull request (PR) para o [repositório do Github `kubernetes/website`](https://github.com/kubernetes/website). |
| 37 | +É recomendável que você se sinta confortável com [git](https://git-scm.com/) e |
| 38 | +[Github](https://lab.github.com/) para trabalhar efetivamente na comunidade Kubernetes. |
29 | 39 |
|
30 | 40 | Para se envolver com a documentação:
|
31 | 41 |
|
32 | 42 | 1. Assine o [Contrato de Licença de Colaborador](https://github.com/kubernetes/community/blob/master/CLA.md) do CNCF.
|
33 | 43 | 2. Familiarize-se com o [repositório de documentação](https://github.com/kubernetes/website) e o [gerador de site estático](https://gohugo.io) hugo.
|
34 | 44 | 3. Certifique-se de entender os processos básicos para [melhorar o conteúdo](https://kubernetes.io/docs/contribute/start/#improve-existing-content) e [revisar alterações](https://kubernetes.io/docs/contribute/start/#review-docs-pull-requests).
|
35 | 45 |
|
36 |
| -## Melhores Práticas recomendadas para contribuições |
| 46 | +Algumas tarefas requerem mais confiança e mais acessos na organização do Kubernetes. |
| 47 | +Veja [Participando no SIG Docs](/docs/contribute/participate/) para mais detalhes |
| 48 | +sobre funções e permissões. |
| 49 | + |
| 50 | +## Sua primeira contribuição |
| 51 | +- Leia sobre [visão geral para contribuição](/docs/contribute/new-content/overview/) para saber mais sobre diferentes formas para você contribuir. |
| 52 | +- Veja a [lista de issues em `kubernetes/website`](https://github.com/kubernetes/website/issues/) para identificar issues que sejam um bom ponto de partida. |
| 53 | +- [Abra um pull request usando o Github](/docs/contribute/new-content/open-a-pr/#changes-using-github) para documentações existentes e aprenda mais sobre resolver issues no Github. |
| 54 | +- Leia sobre o [guia de conteúdo](/docs/contribute/style/content-guide/) e [guias de estilo](/docs/contribute/style/style-guide/). |
| 55 | +- Leia sobre [tipos de conteúdo de páginas](/docs/contribute/style/page-content-types/) e [shortcodes do Hugo](/docs/contribute/style/hugo-shortcodes/). |
37 | 56 |
|
38 |
| -- Escreva mensagens GIT claras e significativas. |
39 |
| -- Certifique-se de incluir _Github Special Keywords_ que faz referência a issue e o fecha automaticamente quando o PR é mergeado. |
40 |
| -- Quando você faz uma pequena alteração em um PR, como corrigir um erro de digitação, qualquer alteração de estilo ou gramática, certifique-se de esmagar seus commits (squash) para não obter um grande número de commits por uma alteração relativamente pequena. |
41 |
| -- Certifique-se de incluir uma boa descrição de PR explicando as alterações no código, o motivo de alterar um trecho de código e garantir que haja informações suficientes para o revisor entender seu PR. |
42 |
| -- Leituras adicionais: |
43 |
| - - [chris.beams.io/posts/git-commit/](https://chris.beams.io/posts/git-commit/) |
44 |
| - - [github.com/blog/1506-closing-issues-via-pull-requests ](https://github.com/blog/1506-closing-issues-via-pull-requests ) |
45 |
| - - [davidwalsh.name/squash-commits-git ](https://davidwalsh.name/squash-commits-git ) |
| 57 | +## Próximos passos |
46 | 58 |
|
47 |
| -## Outras maneiras de contribuir |
| 59 | + - Aprenda a [trabalhar com um clone local](/docs/contribute/new-content/open-a-pr/#fork-the-repo) de um repositório. |
| 60 | + - Documente [funcionalidades em uma release](/docs/contribute/new-content/new-features/). |
| 61 | + - Participe do [SIG Docs](/docs/contribute/participate/), e se torne um |
| 62 | + [membro ou revisor](/docs/contribute/participate/roles-and-responsibilities/). |
| 63 | + - Comece ou ajude com uma [localização](/docs/contribute/localization/). |
48 | 64 |
|
49 |
| -- Para contribuir com a comunidade Kubernetes por meio de fóruns on-line, como Twitter ou Stack Overflow, ou aprender sobre encontros locais e eventos do Kubernetes, visite o a area de [comunidade Kubernetes](/community/). |
50 |
| -- Para contribuir com o desenvolvimento de novas funções, leia o [cheatsheet do colaborador](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet) para começar. |
| 65 | +## Se envolva com o SIG Docs |
51 | 66 |
|
| 67 | +O [SIG Docs](/docs/contribute/participate/) é um grupo de contribuidores que publica e mantém |
| 68 | +a documentação e o site do Kubernetes. Se envolver com o SIG Docs é uma ótima forma de contribuidores Kubernetes (pessoas desenvolvedoras de features ou outros) terem um grande impacto dentro do projeto Kubernetes. |
52 | 69 |
|
| 70 | +A comunicação do SIG Docs é feita de diferentes formas: |
| 71 | + - [Entre em `#sig-docs` no slack do Kubernetes](https://slack.k8s.io/). |
| 72 | + - [Se inscreva na lista de email `kubernetes-dig-docs`](https://groups.google.com/forum/#!forum/kubernetes-sig-docs), onde acontecem discussões e |
| 73 | + decisões oficiais são registradas. |
| 74 | + - [Participe do encontro semanal do SIG Docs](https://github.com/kubernetes/community/tree/master/sig-docs). Os encontros são sempre anunciados no `#sig-docs` e adicionados ao [calendário de eventos de comunidade do Kubernetes](https://calendar.google.com/calendar/embed?src=cgnt364vd8s86hr2phapfjc6uk%40group.calendar.google.com&ctz=America/Los_Angeles). Você precisa baixar o [cliente do Zoom](https://zoom.us/download) ou usar um telefone. |
53 | 75 |
|
54 |
| -## {{% heading "whatsnext" %}} |
| 76 | +## Outras formas de contribuir |
55 | 77 |
|
| 78 | +- Para contribuir com a comunidade Kubernetes por meio de fóruns on-line, como Twitter ou Stack Overflow, ou aprender sobre encontros locais e eventos do Kubernetes, visite a area de [comunidade Kubernetes](/community/). |
| 79 | +- Para contribuir com o desenvolvimento de novas funcionalidades, leia o [cheatsheet do colaborador](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet) para começar. |
| 80 | +- Leia o [cheatsheet de contribuidor](https://github.com/kubernetes/community/tree/master/contributors/guide/contributor-cheatsheet) para saber mais sobre as funcionalidades de desenvolvimento do Kubernetes. |
| 81 | +- Submeta [um post de blog ou um caso de estudo](/docs/contribute/new-content/blogs-case-studies/). |
56 | 82 |
|
57 |
| -- Para obter mais informações sobre os conceitos básicos de contribuição para a documentação, leia [Comece a contribuir](/docs/contribute/start/). |
58 |
| -- Siga o [Guia de estilo de documentação do Kubernetes](/docs/contribute/style/style-guide/) ao propor mudanças. |
59 |
| -- Para mais informações sobre o SIG Docs, leia [Participando do SIG Docs](/docs/contribute/participating/). |
60 |
| -- Para mais informações sobre a localização de documentos do Kubernetes, leia [Localização da documentação do Kubernetes](/docs/contribute/localization/). |
61 | 83 |
|
62 | 84 |
|
0 commit comments