-
Notifications
You must be signed in to change notification settings - Fork 449
Commit Message Style Guide
A commit message should consist of two distinct parts separated by a blank line: the title
and an optional body
. The layout looks like this:
type: subject
body
The title should consist of the type
of the change and subject
separated by a colon :
. Title should be no longer than 50 characters.
The type is contained within the title and can be one of these types:
- feat: a new feature
- fix: a bug fix
- docs: changes to documentation
- style: formatting, missing semi colons, etc; no code change
- refactor: refactoring production code
- test: adding tests, refactoring test; no production code change
- chore: updating build tasks, package manager configs, etc; no production code change
Should begin with a capital letter and not end with a period.
Use an imperative tone to describe what a commit does, rather than what it did. For example, use change; not changed or changes.
If the changes made in a commit are complex, they should be explained in the commit body. Use the body to explain the what and why of a commit, not the how.
When writing a body, the blank line between the title and the body is required and you should limit the length of each line to no more than 72 characters.
Without body
docs: update screenshots in the documentation
or
With body
fix: fix crash caused by new libraries
After merging PRs #126 and #130 crashes were occurring.
These crashes were because of deprecated functions.
Found a solution here (https://stackoverflow.com/questions/22718185)
This will resolve issue #140
Documentation
- Project Requirements
- Setup and Install
- Development
- Database Design
- Initial Docs
- Main Concepts
- Future ideas
- OSH Designs
GSoC Students
- 2018 - Isabel Costa
- GSoC All Final Reports