# Contributing

Contributions are welcome and appreciated. Here's how to get involved.

## Getting Started

1. Fork the repository
2. Create a branch: `git checkout -b feature/<feature-name>`
3. Make your changes
4. Test thoroughly
5. Commit: `git commit -m 'feat(<scope>): short description'`
6. Push your branch and open a Pull Request

## Guidelines

- Keep changes focused — one feature or fix per PR
- Write clear commit messages
- Don't introduce external dependencies unless necessary (only `libdbus-1`)
- If adding a new feature, update documentation to reflect it
- Follow the existing code style — run `clang-format` (config in `.clang-format`) before committing

## Reporting Issues

Open an issue and include:
- Your distro and `networkd-dispatcher` version (the target)
- Compiler version (`cc --version`) and `uname -a`
- The exact command used and the full output
- A log from `/var/log/dispatcher.log` if reproducing in the Docker lab

## Pull Requests

All PRs are reviewed. Small fixes are just as welcome as large features. If you're planning something significant, open an issue first to discuss the direction.