update
This commit is contained in:
79
CONTRIBUTING.md
Normal file
79
CONTRIBUTING.md
Normal file
@@ -0,0 +1,79 @@
|
||||
# Contributing to Munich News Daily
|
||||
|
||||
Thank you for your interest in contributing!
|
||||
|
||||
## Getting Started
|
||||
|
||||
1. Fork the repository
|
||||
2. Clone your fork
|
||||
3. Create a feature branch
|
||||
4. Make your changes
|
||||
5. Run tests
|
||||
6. Submit a pull request
|
||||
|
||||
## Development Setup
|
||||
|
||||
```bash
|
||||
# Clone repository
|
||||
git clone <your-fork-url>
|
||||
cd munich-news
|
||||
|
||||
# Copy environment file
|
||||
cp backend/.env.example backend/.env
|
||||
|
||||
# Start development environment
|
||||
docker-compose up -d
|
||||
|
||||
# View logs
|
||||
docker-compose logs -f
|
||||
```
|
||||
|
||||
## Running Tests
|
||||
|
||||
```bash
|
||||
# Run all tests
|
||||
docker-compose exec crawler python -m pytest tests/crawler
|
||||
docker-compose exec sender python -m pytest tests/sender
|
||||
docker-compose exec backend python -m pytest tests/backend
|
||||
|
||||
# Run specific test
|
||||
docker-compose exec crawler python tests/crawler/test_crawler.py
|
||||
```
|
||||
|
||||
## Code Style
|
||||
|
||||
- Follow PEP 8 for Python code
|
||||
- Use meaningful variable names
|
||||
- Add docstrings to functions
|
||||
- Keep functions small and focused
|
||||
- Write tests for new features
|
||||
|
||||
## Commit Messages
|
||||
|
||||
- Use clear, descriptive commit messages
|
||||
- Start with a verb (Add, Fix, Update, etc.)
|
||||
- Keep first line under 50 characters
|
||||
- Add details in the body if needed
|
||||
|
||||
Example:
|
||||
```
|
||||
Add RSS feed validation
|
||||
|
||||
- Validate URL format
|
||||
- Check feed accessibility
|
||||
- Add error handling
|
||||
```
|
||||
|
||||
## Pull Request Process
|
||||
|
||||
1. Update documentation if needed
|
||||
2. Add tests for new features
|
||||
3. Ensure all tests pass
|
||||
4. Update CHANGELOG.md
|
||||
5. Request review from maintainers
|
||||
|
||||
## Questions?
|
||||
|
||||
Open an issue or reach out to the maintainers.
|
||||
|
||||
Thank you for contributing! 🎉
|
||||
Reference in New Issue
Block a user