mirror of
https://github.com/ChristopherA/Learning-Bitcoin-from-the-Command-Line.git
synced 2025-06-07 07:56:31 +00:00
Translate CONTRIBUTING.md
This commit is contained in:
parent
c4384baea5
commit
86b7e7b45a
64
pt/CONTRIBUTING.md
Normal file
64
pt/CONTRIBUTING.md
Normal file
@ -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)
|
Loading…
x
Reference in New Issue
Block a user