Skip to content

Commit 784b0ae

Browse files
committed
Create CONTRIBUTING.md
1 parent fc68230 commit 784b0ae

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

CONTRIBUTING.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Contributing
2+
3+
## Legal
4+
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
5+
that your contributions are licensed under the Apache 2.0 license (see [LICENSE](LICENSE.txt)).
6+
7+
## Contributor Conduct
8+
All contributors are expected to adhere to the project's [Code of Conduct](CODE_OF_CONDUCT.md).
9+
10+
## Submitting a bug or issue
11+
Please ensure to include the following in your bug report
12+
- A concise description of the issue, what happened and what you expected.
13+
- Simple reproduction steps
14+
- Version of the library you are using
15+
- Contextual information (Swift version, OS etc)
16+
17+
## Submitting a Pull Request
18+
19+
Please ensure to include the following in your Pull Request
20+
- A description of what you are trying to do. What the PR provides to the library, additional functionality, fixing a bug etc
21+
- A description of the code changes
22+
- Documentation on how these changes are being tested
23+
- Additional tests to show your code working and to ensure future changes don't break your code.
24+
25+
Please keep your PRs to a minimal number of changes. If a PR is large try to split it up into smaller PRs. Don't move code around unnecessarily it makes comparing old with new very hard.
26+
27+
The main development branch of the repository is `main`.
28+
29+
### Testing
30+
31+
The project tests expect a local version of mosquitto to be running using the config that is in this project. You can start a local mosquitto MQTT server by running the script `scripts/mosquitto.sh`. You can test the Linux version using Docker. There is a docker-compose file in the root of this project. Run Linux tests as follows
32+
```
33+
docker-compose run test
34+
```
35+
36+
### Formatting
37+
38+
We use Nick Lockwood's SwiftFormat for formatting code. PRs will not be accepted if they haven't be formatted. The current version of SwiftFormat we are using is v0.48.17.

0 commit comments

Comments
 (0)