contributing

---

2. docs/development/contributing.md

# Contributing Guide 🤝

Thank you for your interest in contributing to the M-PESA Analytics Platform!

---

## Development Workflow

1. **Fork** the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Commit using [Conventional Commits](https://www.conventionalcommits.org/)
5. Push and open a Pull Request

---

## Commit Message Format

- `feat:` new feature
- `fix:` bug fix
- `docs:` documentation changes
- `refactor:` code restructuring
- `chore:` maintenance tasks

Example: `feat: add tenant isolation to analytics service`

---

## Code Standards

- **Python**: PEP 8 + Ruff linting
- **Type Hints**: Required for all functions
- **Tests**: Add tests for new features
- **Documentation**: Update relevant docs

---

## Pull Request Requirements

- Clear title and description
- Linked issue (if applicable)
- Passing CI/CD checks
- Updated documentation (if behavior changed)

---

## Areas Needing Contributions

- React Dashboard improvements
- Advanced ML for transaction categorization
- Kubernetes manifests & Helm charts
- More comprehensive tests
- Documentation & examples

---

We welcome contributions of all sizes. Let’s build great African fintech together! 🇰🇪