From 86b7e7b45a8abc5a440430612d9211b94e149d17 Mon Sep 17 00:00:00 2001 From: namcios Date: Mon, 4 Oct 2021 19:05:13 -0300 Subject: [PATCH] Translate CONTRIBUTING.md --- pt/CONTRIBUTING.md | 64 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 pt/CONTRIBUTING.md diff --git a/pt/CONTRIBUTING.md b/pt/CONTRIBUTING.md new file mode 100644 index 0000000..e9692b9 --- /dev/null +++ b/pt/CONTRIBUTING.md @@ -0,0 +1,64 @@ +# Contribuindo + +Nós adoramos a sua contribuição! Queremos deixar o processo de contribuir para este repositório o mais fácil e transparente possível, independente se é para: +- Reportar um bug +- Discutir o estado atual do código +- Enviar uma correção +- Propor novas funcionalidades +- Se tornar um mantenedor + +## Nós Desenvolvemos com o Github +Usamos o GitHub para hospedar o código, rastrear issues e solicitações de recursos e aceitar Pull Requests. + +## Reporte Bugs usando os [issues](https://github.com/BlockchainCommons/Learning-Bitcoin-from-the-Command-Line/issues) do GitHub + +Se você encontrar bugs, erros ou inconsistências no código ou nos documentos deste projeto, informe-nos [abrindo um novo issue](https://github.com/BlockchainCommons/Learning-Bitcoin-from-the-Command-Line/issues/new), mas considere pesquisar os problemas existentes primeiro para verificar se o problema já foi relatado. Se tiver, nunca é demais adicionar um rápido "+1" ou "Eu também tenho esse problema". Isso ajuda a priorizar os problemas e solicitações mais comuns. + +### Escreva Relatórios de Bug com Detalhes, Contexto e Código de Amostra + +[Este é um exemplo](http://stackoverflow.com/q/12488905/180626) de um bom relatório de bug por @briandk. Aqui está [outro exemplo de craig.hockenberry](http://www.openradar.me/11905408). + +**Ótimos relatórios de bug** tendem a ter: + +- Um resumo e/ou contexto rápido +- Passos para reproduzir + - Seja específico! + - Forneça um código de amostra, se puder. [O relatório de bug do StackOverflow](http://stackoverflow.com/q/12488905/180626) inclui código de amostra que *qualquer pessoa* com uma configuração básica de R pode executar para reproduzir o que eu estava vendo +- O que você esperava que acontecesse +- O que realmente acontece +- Observações (possivelmente incluindo por que você acha que isso pode estar acontecendo ou coisas que você tentou que não funcionaram) + +As pessoas *adoram* relatórios de bug completos. Sem brincadeira. + +## Envie Alterações de Código por meio de Pull Requests + +Pull Requests simples para corrigir erros de digitação, documentar ou corrigir pequenos bugs são sempre bem-vindas. + +Pedimos que melhorias mais significativas para o projeto sejam propostas, antes que alguém comece a programar, como um [issue](https://github.com/BlockchainCommons/Learning-Bitcoin-from-the-Command-Line/issues) ou como uma [Pull Request de rascunho](https://github.com/BlockchainCommons/Learning-Bitcoin-from-the-Command-Line/pulls), que é um [novo recurso interessante](https://github.blog/2019-02-14-introducing-draft-pull-requests/) que dá a outros contribuidores a chance de apontar a direção certa, dar feedback sobre o design e talvez discutir se o trabalho relacionado já está em andamento. + +### Use um Estilo de Programação Consistente + +* Recuamos usando dois espaços (soft tabs) +* SEMPRE colocamos espaços após os itens da lista e parâmetros do método ([1, 2, 3], não [1,2,3]), ao redor dos operadores (x + = 1, não x + = 1) e ao redor de setas hash. +* Este é um software de código aberto. Considere as pessoas que lerão seu código e faça com que ele tenha uma boa aparência para elas. É como dirigir um carro: talvez você adore fazer zerinhos quando está sozinho, mas com os passageiros o objetivo é tornar a viagem o mais suave possível. + +### Use [Github Flow](https://guides.github.com/introduction/flow/index.html) para Pull Requests + +Usamos [Github Flow](https://guides.github.com/introduction/flow/index.html). Ao enviar Pull Requests, por favor: + +1. Faça um fork do repo e crie seu branch a partir do `master`. +2. Se você adicionou um código que deve ser testado, adicione testes. +3. Se você alterou APIs, atualize a documentação. +4. Certifique-se de que o conjunto de testes seja aprovado. +5. Certifique-se de que seu código passe por um lint. +6. Emita essa Pull Request! + +### Envie Sob a Licença de Patente BSD-2-Clause Plus + +Resumindo, quando você envia alterações de código, seus envios são considerados disponíveis sob a mesma licença [CC-BY](../ LICENSE-CC-BY-4.0.md) que cobre o projeto. Também pedimos que todos os contribuidores de código do GPG assinem o [Contrato de Licença de Contribuidor (CLA.md)](../CLA.md) para proteger futuros usuários deste projeto. Sinta-se à vontade para entrar em contato com os mantenedores se isso for um problema. + +## Referências + +Partes deste documento CONTRIBUTING.md foram adotadas a partir das melhores práticas de uma série de projetos de código aberto, incluindo: +* [Rascunho do Facebook](https://github.com/facebook/draft-js/blob/a9316a723f9e918afde44dea68b5f9f39b7d9b00/CONTRIBUTING.md) +* [Contribuição de IPFS](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md) \ No newline at end of file