Skip to content

Commit f055c39

Browse files
committed
docs(CONTRIBUTING): initial version
1 parent cfb0eb5 commit f055c39

File tree

1 file changed

+58
-0
lines changed

1 file changed

+58
-0
lines changed

CONTRIBUTING.md

+58
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# How to contribute
2+
3+
Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md).
4+
By participating in this project you agree to abide by its terms.
5+
6+
We appreciate you taking the time to contribute to `octoherd-script-add-cache-to-node-github-action`. Especially as a new contributor, you have a valuable perspective that we lost a long time ago: you will find things confusing and run into problems that no longer occur to us. Please share them with us, so we can make the experience for future contributors the best it could be.
7+
8+
Thank you 💖
9+
10+
## Creating an Issue
11+
12+
Before you create a new Issue:
13+
14+
1. Please make sure there is no [open issue](https://github.com/oscard0m/octoherd-script-add-cache-to-node-github-action/issues?utf8=%E2%9C%93&q=is%3Aissue) yet.
15+
2. If it is a bug report, include the steps to reproduce the issue
16+
3. If it is a feature request, please share the motivation for the new feature, what alternatives you tried, and how you would implement it.
17+
18+
## Setup the repository locally
19+
20+
First, fork the repository.
21+
22+
Setup the repository locally. Replace `<your account name>` with the name of the account you forked to.
23+
24+
```shell
25+
git clone https://github.com/<your account name>/octoherd-script-add-cache-to-node-github-action.git
26+
cd octoherd-script-add-cache-to-node-github-action
27+
npm install
28+
```
29+
30+
Run the tests before making changes to make sure the local setup is working as expected
31+
32+
```shell
33+
npm test
34+
```
35+
36+
## Submitting the Pull Request
37+
38+
- Create a new branch locally.
39+
- Make your changes in that branch and push them to your fork
40+
- Submit a pull request from your topic branch to the main branch on the `oscard0m/octoherd-script-add-cache-to-node-github-action` repository.
41+
- Be sure to tag any issues your pull request is taking care of / contributing to. Adding "Closes #123" to a pull request description will automatically close the issue once the pull request is merged in.
42+
43+
## Maintainers only
44+
45+
### Merging the Pull Request & releasing a new version
46+
47+
Releases are automated using [semantic-release](https://github.com/semantic-release/semantic-release).
48+
The following commit message conventions determine which version is released:
49+
50+
1. `fix: ...` or `fix(scope name): ...` prefix in subject: bumps fix version, e.g. `1.2.3``1.2.4`
51+
2. `feat: ...` or `feat(scope name): ...` prefix in subject: bumps feature version, e.g. `1.2.3``1.3.0`
52+
3. `BREAKING CHANGE:` in body (**Important**: commit body, not subject!): bumps breaking version, e.g. `1.2.3``2.0.0`
53+
54+
Only one version number is bumped at a time, the highest version change trumps the others.
55+
Besides publishing a new version to npm, semantic-release also creates a git tag and release
56+
on GitHub, generates changelogs from the commit messages and puts them into the release notes.
57+
58+
If the pull request looks good but does not follow the commit conventions, use the <kbd>Squash & merge</kbd> button.

0 commit comments

Comments
 (0)