Skip to content

Commit 781ae4b

Browse files
committed
Adding CONTRIBUTING.md
1 parent 4f4c965 commit 781ae4b

File tree

3 files changed

+36
-15
lines changed

3 files changed

+36
-15
lines changed

CONTRIBUTING.md

+20
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# How to Contribute
2+
3+
Thank you so *much* for offering to help out. We truly appreciate it.
4+
5+
If you'd like to contribute, start by searching through the [issues](https://github.com/sparkfun/SparkFun_ICM-20948_ArduinoLibrary/issues) and [pull requests](https://github.com/sparkfun/SparkFun_ICM-20948_ArduinoLibrary/pulls) to see whether someone else has raised a similar idea or question.
6+
Please check the [closed issues](https://github.com/sparkfun/SparkFun_ICM-20948_ArduinoLibrary/issues?q=is%3Aissue+is%3Aclosed)
7+
and [closed pull requests](https://github.com/sparkfun/SparkFun_ICM-20948_ArduinoLibrary/pulls?q=is%3Apr+is%3Aclosed) too - you may find that your issue or feature has already been discussed.
8+
9+
If you decide to add a feature to this library, please create a PR and follow these best practices:
10+
11+
* Change as little as possible. Do not submit a PR that changes 100 lines of whitespace. Break up into multiple PRs if necessary.
12+
* If you've added a new feature document it with a simple example sketch. This serves both as a test of your PR and as a quick way for users to quickly learn how to use your new feature.
13+
* If you add new functions also add them to _keywords.txt_ so that they are properly highlighted in Arduino. [Read more](https://www.arduino.cc/en/Hacking/libraryTutorial).
14+
* **Important:** Please submit your PR using the [release_candidate branch](https://github.com/sparkfun/SparkFun_ICM-20948_ArduinoLibrary/tree/release_candidate). That way, we can merge and test your PR quickly without changing the _master_ branch
15+
16+
![Contributing.JPG](./img/Contributing.JPG)
17+
18+
## Style guide
19+
20+
Please read and follow the [Arduino API style guide](https://www.arduino.cc/en/Reference/APIStyleGuide). Also read and consider the [Arduino style guide](https://www.arduino.cc/en/Reference/StyleGuide).

README.md

+16-15
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,31 @@
1-
SparkFun_ICM-20948_ArduinoLibrary
2-
========================================
1+
# SparkFun_ICM-20948_ArduinoLibrary
32

43
This is the library for the [SparkFun 9DoF IMU Breakout - ICM-20948 (Qwiic)](https://www.sparkfun.com/products/15335).
54

5+
## Contributing
66

7-
Repository Contents
8-
-------------------
7+
If you would like to contribute to this library: please do, we truly appreciate it, but please follow [these guidelines](./CONTRIBUTING.md). Thanks!
98

10-
* **/examples** - Example sketches for the library (.ino). Run these from the Arduino IDE.
11-
* **/src** - Source files for the library (.cpp, .h).
12-
* **keywords.txt** - Keywords from this library that will be highlighted in the Arduino IDE.
13-
* **library.properties** - General library properties for the Arduino package manager.
9+
## Repository Contents
1410

15-
Documentation
16-
--------------
11+
* [**/examples**](./examples) - Example sketches for the library (.ino). Run these from the Arduino IDE.
12+
* [**/src**](./src) - Source files for the library (.cpp, .h).
13+
* [**keywords.txt**](./keywords.txt) - Keywords from this library that will be highlighted in the Arduino IDE.
14+
* [**library.properties**](./library.properties) - General library properties for the Arduino package manager.
15+
* [**CONTRIBUTING.md**](./CONTRIBUTING.md) - Guidelines on how to contribute to this library.
16+
17+
## Documentation
1718

1819
* **[Hookup Guide](https://learn.sparkfun.com/tutorials/sparkfun-9dof-imu-icm-20948-breakout-hookup-guide)** - Basic hookup guide for the SparkFun 9DoF IMU Breakout.
1920
* **[Installing an Arduino Library Guide](https://learn.sparkfun.com/tutorials/installing-an-arduino-library)** - Basic information on how to install an Arduino library.
2021

21-
Products that use this Library
22-
---------------------------------
23-
* [SparkFun 9DoF IMU Breakout - ICM-20948 (Qwiic)](https://www.sparkfun.com/products/15335)
22+
## Products that use this Library
2423

24+
* [SparkFun 9DoF IMU Breakout - ICM-20948 (Qwiic) - SEN-15335](https://www.sparkfun.com/products/15335)
25+
* [SparkFun OpenLog Artemis - DEV-16832](https://www.sparkfun.com/products/16832)
26+
* [SparkFun MicroMod Asset Tracker Carrier Board - DEV-17272](https://www.sparkfun.com/products/17272)
2527

26-
License Information
27-
-------------------
28+
## License Information
2829

2930
This product is _**open source**_!
3031

img/Contributing.JPG

60.7 KB
Loading

0 commit comments

Comments
 (0)