Skip to content

Contributing Guide

Welcome to the DegentCivil contributing guide! We're excited to have you as a potential contributor.

Basic Principles

1. Code of Conduct

  • Be respectful and inclusive
  • Help others learn and grow
  • Provide constructive feedback
  • Follow professional communication standards
  • Report inappropriate behavior

2. Getting Started

  1. Fork the repository
  2. Clone your fork: bash git clone https://github.com/your-username/DegentCivil.git
  3. Create a new branch: bash git checkout -b feature/your-feature-name

3. Development Workflow

  1. Keep Changes Focused
  2. One feature/fix per pull request
  3. Keep changes small and manageable
  4. Write clear commit messages

  5. Code Quality

  6. Follow PEP 8 style guide
  7. Add type hints to new code
  8. Include docstrings for functions and classes
  9. Maintain test coverage

  10. Testing

  11. Run existing tests before submitting
  12. Add tests for new features
  13. Ensure all tests pass

4. Pull Request Process

  1. Update your fork with the latest changes
  2. Run tests locally
  3. Push your changes
  4. Create a pull request with:
  5. Clear description
  6. Reference to related issues
  7. List of changes made
  8. Any breaking changes noted

5. Communication

  • Use GitHub Issues for bug reports
  • Use Discussions for feature requests
  • Be clear and provide context
  • Follow issue/PR templates

🚧 Detailed Documentation Coming Soon! 🚧

This documentation is currently under development. We're working hard to provide more comprehensive guidelines for contributing to DegentCivil.

What to Expect in Full Documentation

  • Setting up development environment
  • Code contribution workflow
  • Pull request guidelines
  • Code review process
  • Documentation standards
  • Community guidelines

Check back soon for updates!