2021-02-21 13:53:51 +00:00
**footnotes** welcomes contributions!
2021-02-20 19:04:22 +00:00
2021-02-21 13:53:51 +00:00
Please follow these guidelines when contributing, as it will give your pull
request the best chance of being accepted:
2021-02-20 19:04:22 +00:00
2021-02-21 13:53:51 +00:00
# Requesting Features/Reporting Bugs
2021-02-20 19:04:22 +00:00
2021-04-12 21:14:13 +01: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
# Contributing Code
2021-04-12 21:14:13 +01:00
- **footnotes** uses [GitHub Flow][github-flow]
2021-02-21 13:53:51 +00:00
- 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` )
2021-04-12 21:14:13 +01:00
- 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
2021-02-21 13:53:51 +00:00
- 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
Issues into the ‘ Review in progress’ bucket
2021-02-20 19:04:22 +00:00
# Commits
2021-04-12 21:14:13 +01:00
- **footnotes** uses [Conventional Commits][conventional-commits]
- we use [PHP Commitizen][php-commitizen] to automate this - use `composer commit`
2021-02-20 19:04:22 +00:00
- keep individual commits as small as possible
# Versioning
2021-04-12 21:14:13 +01:00
- **footnotes** uses [Semantic Versioning][semver]
2021-02-21 13:53:51 +00:00
# Translating
- Translations are welcome!
2021-04-12 21:14:13 +01: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
[php-commitizen]: https://github.com/conventional-commits/php-commitizen
[semver]: https://semver.org/