InfiniTime/doc/contribute.md
Riku Isokoski f9d03cc396 contribute.md: Improve contributing instructions
Denser instructions for absolute beginners. Links to GitHub docs.

Add PR checklist and commit conventions sections based on the
maintainer's guide.
2023-02-12 14:36:04 +02:00

2.2 KiB

How to contribute?

Here are things you can do to help.

Documentation

Documentation might be incomplete, or not clear enough, and it is always possible to improve it with better wording, pictures, videos,... As the documentation is part of the source code, you can submit changes to the documentation by creating a pull request

How to create a pull request?

The workflow is based on GitHub flow.

To create a pull request, you need a fork of the repo. Create a new branch from develop, make changes in this branch, commit them, and create a pull request.

PR checklist

When making changes to the firmware:

You can also check the maintainer's guide for what maintainers will look at in PRs.

Commit conventions

  • Every commit must contain a title and description, that sufficiently explains all the changes in the commit
  • Commits that fix mistakes from previous commits must be squashed
  • Conflicts must be resolved by rebasing, instead of merging