CONTRIBUTING.md

Guia de contribuição

Ficamos muito felizes que você está lendo este guia de contribuição, sempre precisamos de pessoas voluntárias que acreditem na ideia e queiram contribuir com o projeto.

Se você ainda não fez isso, junte-se a nós no nosso grupo aberto do Telegram ou no nosso Discord e participe das discussões. Não hesite em nos procurar para tirar todas as suas dúvidas e conhecer mais sobre o projeto.

Antes de começar

Aqui estão alguns recursos importantes que você deve estar ciente antes de começar:

• Manual de dados abertos para desenvolvedores te explicará um pouco sobre o que são e os principais conceitos por trás dos dados abertos.

• Nossos projetos, são um conjunto de funcionalidades e melhorias que queremos desenvolver nesse repositório. Caso não tenha nada que seja a sua praia, você pode dar uma olhada nos projetos gerais do projeto.

• No nosso Trello você pode acompanhar o que a comunidade em geral vem trabalhando. Lá você encontrá coisas desde fotografia até pedidos de acesso à informação.

Os detalhes de como instalar e executar este projeto podem ser encontrados no README.md.

Reportando bugs

Você encontrou um bug?

• Sugestões de melhoria são rastreadas através de issues e pull requests no GitHub. Verifique se nenhuma issue ou pull request foi criada por outra pessoa com o mesmo bug.
• Se não, crie uma issue explicando o problema e adicionando novas informações detalhadas que ajudem a reproduzir o problema.

Sugerindo melhorias

Você é mais que bem-vinda(o) a sugerir melhorias a MQ. Pedimos apenas que tente incluir o máximo de detalhes possíveis e que verifique se nenhuma issue ou pull request já foi criado por outra pessoa com a mesma sugestão.

Caso seja algo novo, você tem duas alternativas:

• Criar uma nova issue
• Compartilhar a sua sugestão com outros participantes e mantenedores do projeto em nosso Discord

Em ambos, tente usar uma linguagem clara, e com o máximo de detalhes. Qual a motivação, qual problema resolveria e possíveis desafios, por exemplo, são importantes para entender o que você precisa. Esse é um projeto de código aberto, mantido por voluntários. Frequentemente precisamos escolher bem o que vamos fazer com os recursos que temos. :)

Criando pull requests

Você decidiu contribuir para o projeto! Yay!

Faça um fork do projeto e crie uma nova branch. Mais detalhes aqui.

Aqui algumas dicas:

• Caso decida trabalhar em alguma issue, comente na issue escolhida. Dessa forma, outras pessoas saberão que tem alguém trabalhando nela. Caso tenha ficado perdido ou com dúvidas, peça ajuda.

• Caso tenha visto algo pontual, como um typo ou algo que pode ser corrigido e testado rapidamente e não envolva mudanças estruturais, você é bem vindo a abrir um novo PR também.

• Antes de qualquer coisa, tente rodar o projeto localmente.

• Instale o pre-commit localmente. Dessa forma, o código que você commitar já estará formatado, com os imports ordenados e mais arrumado.

• Rode os testes localmente. Além de ser uma boa prática, previne idas e vindas nas revisões.

• Adicione novos testes para novas funcionalidades ou bugs.

• Use o tempo presente nas mensagens do commit. Exemplo: "Adiciona funcionalidade" e não "Adicionada a funcionalidade".

• Atualize o README.md com os detalhes da mudança caso esta inclua uma nova base de dados ou um novo comando na CLI.

• Embora o código esteja escrito em inglês, por convenção, as mensagens de commit, comentários, pull requests, issues, e demais comunicações do projeto deverão ser escritas em português.

• Marque a opção "Permitir edição pelos mantenedores". Assim poderemos fazer modificações de emergência mantendo o pull request aberto por você.

Sentiu falta de algo nesse guia? Conta pra gente!

Bem vinda(o) ao Dados Abertos de Feira!