# Contributing

## Legal
By submitting a pull request, you represent that you have the right to license your contribution to the community, and agree by submitting the patch
that your contributions are licensed under the Apache 2.0 license (see [LICENSE](LICENSE)).

## Contributor Conduct
All contributors are expected to adhere to the project's [Code of Conduct](CODE_OF_CONDUCT.md).

## Submitting a bug or issue
Please ensure to include the following in your bug report
- A consise description of the issue, what happened and what you expected.
- Simple reproduction steps
- Version of the library you are using
- Contextual information (Swift version, OS etc)

## Adding a Feature
Prior to adding features to Hummingbird, please discuss the feature request in an issue and/or on our Discord server. That way we can shape the new feature together, make it fit the project, and validate it's within our vision of the framework.

## Submitting a Pull Request
Please ensure to include the following in your Pull Request
- A link referencing the issue (bug or feature request) it fixes
- A description of the code changes
- Documentation on how these changes are being tested
- Additional tests to show your code working and to ensure future changes don't break your code.

Please keep your PRs to a minimal number of changes, this helps us review and merge it timely. If a PR is large try to split it up into smaller PRs. Don't move code around unnecessarily as it makes comparing old with new very hard.

The main development branch of the repository is  `main`.

### Formatting
We use Apple's swift-format for formatting code. PRs will not be accepted until they're formatted.