Pular para o conteúdo principal

Contribuindo

Este é um projeto pessoal e em evolução, mas contribuições são bem-vindas 🙂

Se você encontrou um bug, tem uma sugestão ou quer enviar código, abaixo está o fluxo esperado.

Issues e Discussions​

Antes de qualquer mudança em código:

  • 🐛 Bugs / problemas técnicos
    → Abra uma Issue

  • 💡 Ideias, dúvidas ou sugestões
    → Use Discussions

Não precisa formalidade excessiva — contexto claro já ajuda bastante.

Enviando Código (Pull Request)​

Se quiser contribuir com código ou documentação:

1. Fork e clone​

git clone https://github.com/<seu-usuario>/SimuladorFinanceiro.git
cd SimuladorFinanceiro

(opcional, mas recomendado)

git remote add upstream https://github.com/LiloMarino/SimuladorFinanceiro.git

2. Crie uma branch​

git checkout -b feature/minha-alteracao

Sugestões de prefixo:

  • feature/ – funcionalidade nova
  • fix/ – correção de bug
  • docs/ – documentação
  • refactor/ – refatoração

3. Faça as mudanças​

  • Mantenha a alteração focada
  • Evite misturar refatoração grande com feature
  • Se for algo maior, vale abrir uma Issue antes

4. Commit e push​

git add .
git commit -m "feat: descrição curta da mudança"
git push origin feature/minha-alteracao

5. Abra a Pull Request​

  • Base: main
  • Descreva o que mudou e por quê
  • Se existir Issue relacionada, mencione (Closes #123)

Observações​

  • O projeto é mantido por uma única pessoa, então análises de PR podem levar um tempo
  • Nem toda ideia será aceita, mas toda sugestão é válida para discussão
  • Feedback e contribuições são sempre bem-vindos

Licença​

Ao contribuir, você concorda que seu código será licenciado sob GPL-3.0, assim como o restante do projeto.