Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
98 lines (67 loc) · 1.75 KB

CONTRIBUTING.md

File metadata and controls

98 lines (67 loc) · 1.75 KB
Raw

Contribuindo

Contribuições são bem-vindas! Este guia ajudará você a começar.

Como Contribuir

Reportar Bugs

Reporte bugs em https://github.com/ivanjun10r/django_govbr_theme/issues.

Inclua:

  • Sistema operacional e versão
  • Versão do Python e Django
  • Passos para reproduzir o bug

Propor Features

Abra uma issue descrevendo:

  • O que a feature faria
  • Por que seria útil
  • Como funcionaria

Enviar Pull Requests

  1. Fork o projeto
  2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
  3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
  4. Push para a branch (git push origin feature/MinhaFeature)
  5. Abra um Pull Request

Setup de Desenvolvimento

# Fork e clone
git clone git@github.com:seu_usuario/django_govbr_theme.git
cd django_govbr_theme

# Ambiente virtual
pyenv virtualenv 3.12 django_govbr_theme
pyenv activate django_govbr_theme

# Instalar
pip install -e '.[test,dev]'
npm install

# Pre-commit hooks
pre-commit install

Testes

# Executar testes
pytest

# Com coverage
pytest --cov=django_govbr_theme

# Tox (múltiplas versões)
tox

Estilo de Código

# Formatar
ruff format .

# Verificar
ruff check .

# Pre-commit
pre-commit run --all-files

Versionamento

Seguimos Semantic Versioning:

  • MAJOR: Mudanças incompatíveis
  • MINOR: Novas funcionalidades compatíveis
  • PATCH: Correções de bugs

Diretrizes

  • Escreva testes para novas features
  • Mantenha cobertura de testes alta
  • Siga PEP 8
  • Documente código complexo
  • Atualize documentação quando necessário

Código de Conduta

Participe com respeito. Veja CODE_OF_CONDUCT.md.

Dúvidas?

Abra uma issue ou entre em contato!