2021-04-25 08:28:02 +00:00
|
|
|
|
# **footnotes** Contributing Guide
|
|
|
|
|
|
2021-02-21 13:53:51 +00:00
|
|
|
|
**footnotes** welcomes contributions!
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Code of Conduct
|
|
|
|
|
|
|
|
|
|
Please read and ensure that you adhere to the project's [Code of Conduct][coc].
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Requesting Features/Reporting Bugs
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
To request a new feature or to report a bug, create an [Issue][new-issue] and
|
|
|
|
|
choose the correct template.
|
2021-02-21 13:53:51 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Contributing Code
|
2021-02-21 13:53:51 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
- **footnotes** uses [GitHub Flow][github-flow];
|
|
|
|
|
- branch off of `main` to start developing (`git checkout -b <your branch>`);
|
|
|
|
|
- ensure that your new branch has a descriptive name;
|
|
|
|
|
- create a remote copy of your new branch (`git push`);
|
|
|
|
|
- create a draft [pull request][pull-request] to merge your branch with `main` —
|
|
|
|
|
tag any related Issues, and if they are assigned to a Project board, this will
|
|
|
|
|
automatically move them into the ‘In Progress’ bucket; and
|
|
|
|
|
- when you think you're finished, un-draft your pull request — if the PR is
|
2021-02-21 13:55:22 +00:00
|
|
|
|
assigned to a Project board, this will automatically move it and any related
|
2021-04-25 08:28:02 +00:00
|
|
|
|
Issues into the ‘Review in progress’ bucket.
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Commits
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
- **footnotes** uses the [Conventional Commits][conventional-commits] for
|
|
|
|
|
commit message formatting;
|
|
|
|
|
- we recommend using [Commitizen][commitizen] to automate this:
|
|
|
|
|
- install it globally using `npm install -g commitizen`;
|
|
|
|
|
- use `git cz` instead of `git commit`.
|
|
|
|
|
- keep individual commits as small as possible.
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Versioning
|
2021-02-20 19:04:22 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
**footnotes** uses [WordPress Versioning][wpver].
|
2021-02-21 13:53:51 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
## Translating
|
2021-02-21 13:53:51 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
Translations are welcome!
|
2021-04-12 20:14:13 +00:00
|
|
|
|
|
2021-04-25 08:28:02 +00:00
|
|
|
|
[coc]: https://github.com/markcheret/footnotes/blob/main/CODE_OF_CONDUCT.md
|
2021-04-12 20:14:13 +00:00
|
|
|
|
[new-issue]: https://github.com/markcheret/footnotes/issues/new/choose
|
|
|
|
|
[github-flow]: https://githubflow.github.io/
|
|
|
|
|
[pull-request]: https://github.com/markcheret/footnotes/compare
|
|
|
|
|
[conventional-commits]: https://www.conventionalcommits.org
|
2021-04-25 08:28:02 +00:00
|
|
|
|
[commitizen]: https://www.npmjs.com/package/commitizen
|
|
|
|
|
[wpver]: https://make.wordpress.org/core/handbook/about/release-cycle/version-numbering/
|