Files
espurna/CONTRIBUTING.md
Maxim Prokhorov 82feb95daa test(build): configurable paths & .gitignore test caches
add one more level of directories for build config & its cache
replace test/pio_cache w/ test/build/cache
2025-06-08 22:07:56 +03:00

1.7 KiB

Do you want to do a pull request?

First things first: THANK YOU!. ESPurna started as a personal project and it will be great if it becomes a community project. There are so many things that can be improved, added and fixed (yeah, a lot a small bugs and not so small bugs there, I'm sure). And sometimes I just don't have the time to work on it as much as I'd like to.

Second. Let's try to keep it homogeneous and readable. I have my coding style. It's mostly standard but sometimes it can be opinionated. It you are willing to do a pull request, there are a few things I would ask you first:

Pull request

  • Do the pull request against the dev branch
  • Only touch relevant files (beware if your editor has auto-formatting feature enabled)
  • If you are adding a new functionality (new hardware, new library support) not related to an existing component move it to it's own modules (.cpp or .h file)
  • If the code you are adding is optional or not always enabled, make sure to include and enable *_SUPPORT flag in one of the sample test/build/config/*.h profiles. This would ensure that our CI would always build it.
  • When it is possible, add a unit test or improve existing ones. See test/unit/src
  • Make sure you check Coding Style
  • PRs that don't compile or cause more coding errors will not be merged. Please fix the issue. Same goes for PRs that are raised against older commit in dev - you might need to rebase and resolve conflicts.

And thank you again!