CONTRIBUTING.md

Contributing to STM32_PWM

Reporting Bugs

Please report bugs in STM32_PWM Issues if you find them.

However, before reporting a bug please check through the following:

• Existing Open Issues - someone might have already encountered this.

If you don't find anything, please open a new issue.

How to submit a bug report

Please ensure to specify the following:

• Arduino IDE version (e.g. 1.8.19) or Platform.io version
• STM32 Core Version (e.g. STM32 core v2.4.0)
• Board type and relevant info
• Contextual information (e.g. what you were trying to achieve)
• Simplest possible steps to reproduce
• Anything that might be relevant in your opinion, such as:
  • Operating system (Windows, Ubuntu, etc.) and the output of uname -a
  • Network configuration

Please be educated, civilized and constructive as you've always been. Disrespective posts against GitHub Code of Conduct will be ignored and deleted.

---

Example

Arduino IDE version: 1.8.19
STM32 Core Version 2.4.0
Nucleo-144 STM32H7 NUCLEO_H743ZI2
OS: Ubuntu 20.04 LTS
Linux xy-Inspiron-3593 5.15.0-58-generic #64~20.04.1-Ubuntu SMP Fri Jan 6 16:42:31 UTC 2023 x86_64 x86_64 x86_64 GNU/Linux

Context:
I encountered a crash while using this library

Steps to reproduce:
1. ...
2. ...
3. ...
4. ...

---

Sending Feature Requests

Feel free to post feature requests. It's helpful if you can explain exactly why the feature would be useful.

There are usually some outstanding feature requests in the existing issues list, feel free to add comments to them.

---

Sending Pull Requests

Pull Requests with changes and fixes are also welcome!

Please use the astyle to reformat the updated library code as follows (demo for Ubuntu Linux)

1. Change directory to the library GitHub

xy@xy-Inspiron-3593:~$ cd Arduino/xy/STM32_PWM_GitHub/
xy@xy-Inspiron-3593:~/Arduino/xy/STM32_PWM_GitHub$

2. Issue astyle command

xy@xy-Inspiron-3593:~/Arduino/xy/STM32_PWM_GitHub$ bash utils/restyle.sh