36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# Development contributions
|
|
|
|
We like pull requests from everyone. By participating in this project, you
|
|
agree to follow the code of conduct below
|
|
|
|
[code of conduct](https://github.com/1technophile/OpenMQTTGateway/blob/master/CODE_OF_CONDUCT.md)
|
|
|
|
[code style guide](https://google.github.io/styleguide/cppguide.html#Formatting)
|
|
So as to format automaticaly your document you have to add the "clang-Format" extension to VSCode, once done, you can format the code by doing a right click into the code file window and clicking "Format document".
|
|
|
|
Fork the [development branch](https://github.com/1technophile/OpenMQTTGateway/tree/development), then clone the repo
|
|
|
|
Make your modification,
|
|
* If you want to add a new gateway, name it `ZgatewayXXX`, `XXX` replaced by your gateway communication type, can be more than three letters
|
|
* If you want to add a new sensor, name it `ZsensorYYY`, `YYY` replaced by your sensor type, can be more than three letters
|
|
* If you want to add a new actuator, name it `ZactuatorZZZ`, `ZZZ` replaced by your actuator type, can be more than three letters
|
|
|
|
Review your code, compile it for Arduino Uno, ESP32 and ESP8266
|
|
|
|
Test it locally on your hardware config
|
|
|
|
Emit a pull request
|
|
|
|
Verify the GitHub Actions CI compilation results
|
|
|
|
Request for review
|
|
|
|
We may suggest some changes, improvements or alternatives.
|
|
|
|
Some things that will increase the chance that your pull request is accepted:
|
|
* Comment your code,
|
|
* Ask eventually for design guidelines,
|
|
* Write a [good commit message][commit].
|
|
|
|
[commit]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
|