Nota do tradutor
Esta é a tradução de contributing.md. Este link compara a versão em que se baseou esta tradução com a última versão disponível no branch master do AVA. Se não houver mudanças em contributing.md, então a tradução está atualizada.
✨ Obrigado por contribuir com o AVA! ✨
Por favor, note que este projecto é lançado com um Código de Conduta do Contribuidor. Ao participar neste projecto, você concorda em cumprir seus termos.
Traduções: Español, Français, Italiano, 日本語
Como um usuário do AVA, você é o candidato perfeito para nos ajudar a melhorar a nossa documentação. Correções de erro de digitação, correções de erro, melhores explicações e mais exemplos, etc. Issues em aberto para as coisas que poderiam ser melhoradas. Ajude a traduzir nossa documentação. Qualquer coisa. Até mesmo melhorias para este documento.
Algumas issues são criadas sem informações suficientes, não podem ser reproduzidas, ou não são válidas. Ajude-nos a torná-las mais fáceis de serem resolvidas. Lidar com issues ocupa muito tempo que poderia ser usado para corrigir bugs e adicionar funcionalidades.
Estamos sempre à procura de mais opiniões em discussões no issue tracker. É uma boa oportunidade de influenciar o rumo do AVA.
Nós temos um chat. Dê um pulo lá e espie, fale conosco, e ajude os outros.
- O issue tracker é para issues. Use nosso chat ou o Stack Overflow para suporte.
- Pesquise o issue tracker antes de abrir uma issue.
- Certifique-se de que você está usando a versão mais recente do AVA.
- Use um título claro e descritivo.
- Inclua o máximo possível de informações: etapas para reproduzir a issue, mensagem de erro, versão do Node.js, sistema operacional, etc.
- Quanto mais tempo você colocar em uma issue, quanto mais nós colocaremos.
- O melhor relatório de issue é um teste falho provando-a.
- Mudanças não-triviais muitas vezes são primeiramente melhor discutidas em uma issue, para impedí-lo de fazer trabalho desnecessário.
- Para tarefas ambiciosas, você deve, o mais breve possível, tentar disponibilizar o seu trabalho na comunidade para feedback. Abra uma pull request assim que tiver o mínimo necessário para demonstrar sua idéia. Nesta fase inicial, não se preocupe em fazer as coisas perfeitas, ou 100% completas. Adicione um prefixo [WIP] ao título e descreva o que você ainda precisa fazer. Isso previne os revisores de apontarem pequenos detalhes ou melhorias que você já sabe que precisa fazer.
- Novas funcionalidades devem ser acompanhadas de testes e documentação.
- Não inclua mudanças não relacionadas.
- Faça lint e teste antes de submeter a pull request executando
$ npm test. - Faça a pull request a partir de um topic branch, e não do master.
- Use um título claro e descritivo para a pull request e os commits.
- Escreva uma descrição convincente do motivo pelo qual devemos aceitar sua pull request. É seu trabalho nos convencer. Responda "por que" ela é necessária e forneça casos de uso.
- Podemos pedir que faça mudanças à sua pull request. Nunca há necessidade de abrir outra pull request. Apenas atualize a existente.