mirror of
https://github.com/Wessel/PICAMP.git
synced 2026-07-14 12:23:36 +02:00
40 lines
1.6 KiB
Markdown
40 lines
1.6 KiB
Markdown
# Contributing
|
|
|
|
<!---
|
|
Used linters:
|
|
[ESLint](https://eslint.org/)
|
|
[EditorConfig](https://editorconfig.org)
|
|
--->
|
|
|
|
If you wish to contribute to PICAMP, feel free to fork the repository and submit a pull request.
|
|
editorconfig is enforced to correct most typo's you make and keep the code style the same throughout the whole project,
|
|
so it would be much appreciated if you installed editorconfig to your editor of choice
|
|
|
|
<!---
|
|
Prerequisites for Node.JS:
|
|
|
|
* [Node.JS V18.14.0](https://nodejs.org/en/)
|
|
* [Docker](https://www.docker.com)
|
|
* [ESLint](https://eslint.org)
|
|
* [(OPTIONAL) Yarn](https://yarnpkg.com)
|
|
--->
|
|
## Prerequisites
|
|
The following prerequisites must be met before installing PICAMP:
|
|
- [XC8 v2.45](https://www.microchip.com/en-us/tools-resources/develop/mplab-xc-compilers)
|
|
- [MPLAB X IDE/IPE](https://www.microchip.com/en-us/tools-resources/develop/mplab-x-ide)
|
|
- [MPLAB PICKit In-Circuit Debugger](https://www.microchip.com/en-us/development-tool/pg164150)
|
|
|
|
## Setup
|
|
To get ready to work on the codebase, please do the following:
|
|
|
|
1. Fork & clone the repository, and make sure you are on the **master** branch
|
|
2. Open the project in MPLAB X
|
|
3. Code your ideas and test them using the PICKit
|
|
4. [Submit a pull request](https://github.com/wessel/PICAMP/compare)
|
|
|
|
## Testing
|
|
When creating any new functions, please also create unit tests for them in the `tests` directory.
|
|
Use the library associated with the project when creating such tests.
|
|
|
|
When modifying existing functions, make sure to test them before making a pull request, this will prevent
|
|
anything from breaking on the production environment. |