Skip to content

Commit

Permalink
docs/contributing: add commit message examples
Browse files Browse the repository at this point in the history
REFERENCE: #48
  • Loading branch information
MichaelHirn committed Feb 24, 2016
1 parent 60164d1 commit b265726
Showing 1 changed file with 27 additions and 6 deletions.
33 changes: 27 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,7 @@ overview of how you can contribute to Leaf.
* [Documentation Guidelines](#documentation-guidelines)


If you have questions hop on the [Leaf Chat](https://gitter.im/autumnai/leaf)
, or reach out to {@[MJ](https://twitter.com/mjhirn), @[Max](https://twitter.com/hobofan)}.
If you have questions hop on the [Leaf Chat](https://gitter.im/autumnai/leaf), to the #rust-machine-learning IRC on irc.mozilla.org or reach out to {@[MJ](https://twitter.com/mjhirn), @[Max](https://twitter.com/hobofan)}.

## Pull Requests

Expand Down Expand Up @@ -117,8 +116,30 @@ open an issue in the repository.

We have very precise rules over how git commit messages should be formatted.
This leads to more readable messages that are easy to follow when looking
through the project history. But also, we may use the git commit messages to
auto-generate the Leaf change log.
through the project history. The commit guidelines help us to auto-generate the CHANGELOG. More information about it, can be found in the [`Guide to CHANGELOG in Rust` post][2].

#### Commit Message Examples

Following some valid commit message examples. A syntax explanation can be found in the following section, Commit Message Format.

Example for a mature commit message.
```
docs/readme: add contact section to README.md
A lot of people have asked about contact details, so I decided it would be a good idea to include our contact details in the README.md
REFERENCE: #4, #63
CLOSE: #52
```

Another example on how you would make the commit on the command line.
```
git commit -m 'feat/solver: add Adagrad as SGD-based solver
Some more context and explanation about the commit, PR.
CLOSE: #42'
```

#### Commit Message Format

Expand Down Expand Up @@ -149,8 +170,7 @@ Must be one of the following:

<**scope**>:

The scope could be anything that specifies the place of the commit change.
For example: `feature1`, `tests`, `lib`, etc...
The scope could be anything that specifies the place of the commit change, e.g. `solver`, `[filename]`, `tests`, `lib`, ... we are not very restrictive on the scope. The scope should just be lowercase and if possible contain of a single word, this makes the CHANGELOG generation easier.

<**subject**>:

Expand Down Expand Up @@ -190,3 +210,4 @@ and efficient communication Framework for providing developers and users with
helpful Documentation about the Deep Learning Framework.

[1]: https://medium.com/@autumn_eng/increasing-open-source-engagement-with-structural-communication-guidelines-for-code-documentation-e72533de8e45
[2]: https://medium.com/@autumn_eng/guide-to-changelog-md-in-rust-6eb349808fa4

0 comments on commit b265726

Please sign in to comment.