diff --git a/content/pt/docs/contribute/_index.md b/content/pt/docs/contribute/_index.md new file mode 100644 index 0000000000..0e947a36a2 --- /dev/null +++ b/content/pt/docs/contribute/_index.md @@ -0,0 +1,61 @@ +--- +content_template: templates/concept +title: Contribua com o Kubernetes docs +linktitle: Contribute +main_menu: true +weight: 80 +--- + +{{% capture 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. +{{% /capture %}} + +{{% capture 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. + +Para se envolver com a documentação: + +1. Assine o [Contrato de Licença de Colaborador](https://github.com/kubernetes/community/blob/master/CLA.md) do CNCF. +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 + +- 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 ) + +## Outras maneiras 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. + +{{% /capture %}} + +{{% capture 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/). + +{{% /capture %}}