mirror of
https://github.com/Wessel/PICAMP.git
synced 2026-07-27 02:10:53 +02:00
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
# Contributing
|
|
|
|
<!---
|
|
Used linters:
|
|
[ESLint](https://eslint.org/)
|
|
[EditorConfig](https://editorconfig.org)
|
|
--->
|
|
|
|
If you wish to contribute to PICDAC, 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 PICDAC:
|
|
- [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)
|
|
|
|
<!---
|
|
Install commands:
|
|
JavaScript/TypeScript: `yarn --dev` or `npm install --dev`
|
|
Rust: `cargo run`
|
|
C: `make clean install`
|
|
|
|
Run commands:
|
|
JavaScript/TypeScript: `yarn test` or `npm run test`
|
|
Rust: `cargo run`
|
|
C: `make clean dev`
|
|
--->
|
|
## 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/PICDAC/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. |