Skip to content

Commit e71fdc3

Browse files
author
Allan Pope
authored
feat: add contributing guide (#23)
* Add notes for 'about the project' * Add notes on how to contribute
1 parent 84ba82e commit e71fdc3

File tree

1 file changed

+38
-0
lines changed

1 file changed

+38
-0
lines changed

CONTRIBUTING.md

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Contributing
2+
3+
## About the project
4+
5+
### Development tools:
6+
7+
- TypeScript
8+
- Jest
9+
- ESLint
10+
11+
### CI tools:
12+
13+
- Github actions
14+
- Semantic release
15+
16+
### Github actions
17+
18+
Creating a pull request will trigger the CI workflow. The CI runs tests and linters on different operating systems and versions of Node. It must pass before your pull request can merged into master.
19+
20+
On merging the pull request the release workflow will be fired. The release workflow ensures the latest code is released to NPM. Using the conventional commits pattern, the commit is analysed and a new version of the package is released.
21+
22+
The two folders of interest are `src` and `tests`. The `tests` folder follows the `src` directory structure and includes a test for each file in `src`
23+
24+
Inside the `src` folder you'll see the folders `data` and `nodes`. The `data` folder handles fetching data, while the `nodes` directory handles building the Gatsby node objects.
25+
26+
## Running the project
27+
28+
- Navigate to the root directory in your terminal
29+
- Run `npm install`
30+
- Run `npm run watch` to compile the files
31+
- Run `npm run test` to run the test suite
32+
33+
## How to contribute
34+
35+
- Make your changes on a branch
36+
- Create a pull request describing your changes/edits
37+
- Make sure you've added tests for your changes and the existing tests still pass
38+
- Ask for the pull request to be reviewed

0 commit comments

Comments
 (0)