feat: add contribute index translation update

This commit is contained in:
edsoncelio
2021-07-17 13:48:55 -03:00
parent 0ca94eebab
commit 3dd33ef107
+56 -34
View File
@@ -1,31 +1,41 @@
---
content_type: concept
title: Contribua com o Kubernetes docs
linktitle: Contribute
title: Contribua com a documentação do Kubernetes
linktitle: Contribuir
main_menu: true
weight: 80
no_list: true
card:
name: contribuir
weight: 10
title: Comece a contribuir para o K8s
---
---
<!-- overview -->
Caso você gostaria de contribuir com a documentação ou o site do Kubernetes,
ficamos felizes em ter sua ajuda! Qualquer pessoa pode contribuir, seja você novo no
projeto ou se você já esta no mercado há muito tempo. Além disso, Se você se identifica como
desenvolvedor, usuário final ou alguém que simplesmente não suporta ver erros de digitação.
*O Kubernetes agradece as melhorias de todos os contribuidores, novos e experientes!*
{{< note >}}
Para saber mais sobre como contribuir o Kubernetes em geral, veja a
[documentação para contribuidor](https://www.kubernetes.dev/docs/).
{{< /note >}}
Este site é mantido pelo [Kubernetes SIG Docs](/docs/contribute/#get-involved-with-sig-docs).
Contribuidores da documentação do Kubernetes podem:
- Melhorar o conteúdo existente
- Criar novo conteúdo
- Traduzir a documentação
- Gerenciar e publicar a documentação como parte do ciclo de lançamento do Kubernetes
<!-- body -->
## Começando
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).
Algumas tarefas exigem mais confiança e precisam de mais acesso na organização Kubernetes.
Veja [Participando do SIG Docs](/docs/contribute/participating/) para mais detalhes sobre
as funções e permissões.
A documentação do Kubernetes reside em um repositório do GitHub. Nós damos as boas-vindas
a todas as contribuições, mas você vai precisa estar familiarizado com o uso básico de git e GitHub para
operar efetivamente na comunidade Kubernetes.
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).
É recomendável que você se sinta confortável com [git](https://git-scm.com/) e
[Github](https://lab.github.com/) para trabalhar efetivamente na comunidade Kubernetes.
Para se envolver com a documentação:
@@ -33,30 +43,42 @@ Para se envolver com a documentação:
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.
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).
## Melhores Práticas recomendadas para contribuições
Algumas tarefas requerem mais confiança e mais acessos na organização do Kubernetes.
Veja [Participando no SIG Docs](/docs/contribute/participate/) para mais detalhes
sobre funções e permissões.
- Escreva mensagens GIT claras e significativas.
- Certifique-se de incluir _Github Special Keywords_ que faz referência a issue e o fecha automaticamente quando o PR é mergeado.
- 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.
- 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.
- Leituras adicionais:
- [chris.beams.io/posts/git-commit/](https://chris.beams.io/posts/git-commit/)
- [github.com/blog/1506-closing-issues-via-pull-requests ](https://github.com/blog/1506-closing-issues-via-pull-requests )
- [davidwalsh.name/squash-commits-git ](https://davidwalsh.name/squash-commits-git )
## Sua primeira contribuição
- Leia sobre [visão geral para contribuição](/docs/contribute/new-content/overview/) para saber mais sobre diferentes formas para você contribuir.
- Veja a [lista de issues em `kubernetes/website`](https://github.com/kubernetes/website/issues/) para identificar issues que sejam um bom ponto de partida.
- [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.
- Leia sobre o [guia de conteúdo](/docs/contribute/style/content-guide/) e [guias de estilo](/docs/contribute/style/style-guide/).
- Leia sobre [tipos de conteúdo de páginas](/docs/contribute/style/page-content-types/) e [shortcodes do Hugo](/docs/contribute/style/hugo-shortcodes/).
## Outras maneiras de contribuir
## Próximos passos
- Aprenda a [trabalhar com um clone local](/docs/contribute/new-content/open-a-pr/#fork-the-repo) de um repositório.
- Documente [funcionalidades em uma release]/docs/contribute/new-content/new-features/).
- Participe do [SIG Docs](/docs/contribute/participate/), e se torne um
[membro ou revisor](/docs/contribute/participate/roles-and-responsibilities/).
- Comece ou ajude com uma [localização](/docs/contribute/localization/).
## Se envolva com o SIG Docs
O [SIG Docs](/docs/contribute/participate/) é um grupo de contribuidores que publica e mantém
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.
A comunicação do SIG Docs é feita de diferentes formas:
- [Entre em `#sig-docs` no slack do Kubernetes](https://slack.k8s.io/).
- [Se inscreva na lista de email `kubernetes-dig-docs`](https://groups.google.com/forum/#!forum/kubernetes-sig-docs), onde acontecem discussões e
decisões oficiais são registradas.
- [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.
## Outras formas de contribuir
- 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/).
- 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.
- 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.
- 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.
- Submeta [um post de blog ou um caso de estudo](/docs/contribute/new-content/blogs-case-studies/).
## {{% heading "whatsnext" %}}
- Para obter mais informações sobre os conceitos básicos de contribuição para a documentação, leia [Comece a contribuir](/docs/contribute/start/).
- Siga o [Guia de estilo de documentação do Kubernetes](/docs/contribute/style/style-guide/) ao propor mudanças.
- Para mais informações sobre o SIG Docs, leia [Participando do SIG Docs](/docs/contribute/participating/).
- Para mais informações sobre a localização de documentos do Kubernetes, leia [Localização da documentação do Kubernetes](/docs/contribute/localization/).