summaryrefslogtreecommitdiff
path: root/doc/leap-commit-template.README
diff options
context:
space:
mode:
authordrebs <drebs@leap.se>2015-04-21 17:02:47 -0300
committerdrebs <drebs@leap.se>2015-04-21 17:02:47 -0300
commitad8c61d00fb7d2474d129a5bb553dd0f5206f279 (patch)
treef6b6ee915ebe28b61655bbbd2c8ed57e1bc72020 /doc/leap-commit-template.README
parent5d0fffda31e0f07f7f8396fda961d3d0fac33733 (diff)
parent799703cf884191d097eb5d5316fa964e421683fd (diff)
Merge tag '0.6.2' into debian/release-0.6.2
Tag leap.mx version 0.6.2 Conflicts: CHANGELOG src/leap/mx/mail_receiver.py
Diffstat (limited to 'doc/leap-commit-template.README')
-rw-r--r--doc/leap-commit-template.README47
1 files changed, 47 insertions, 0 deletions
diff --git a/doc/leap-commit-template.README b/doc/leap-commit-template.README
new file mode 100644
index 0000000..ce8809e
--- /dev/null
+++ b/doc/leap-commit-template.README
@@ -0,0 +1,47 @@
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+HOW TO USE THIS TEMPLATE:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Run `git config commit.template docs/leap-commit-template` or
+edit the .git/config for this project and add
+`template = docs/leap-commit-template`
+under the [commit] block
+
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+COMMIT TEMPLATE FORMAT EXPLAINED
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+[type] <subject>
+
+<body>
+<footer>
+
+Type should be one of the following:
+- bug (bug fix)
+- feat (new feature)
+- docs (changes to documentation)
+- style (formatting, pep8 violations, etc; no code change)
+- refactor (refactoring production code)
+- test (adding missing tests, refactoring tests; no production code change)
+- pkg (packaging related changes; no production code change)
+- i18n translation related changes
+
+Subject should use imperative tone and say what you did.
+For example, use 'change', NOT 'changed' or 'changes'.
+
+The body should go into detail about changes made.
+
+The footer should contain any issue references or actions.
+You can use one or several of the following:
+
+- Resolves: #XYZ
+- Related: #XYZ
+- Documentation: #XYZ
+- Releases: XYZ
+
+The Documentation field should be included in every new feature commit, and it
+should link to an issue in the bug tracker where the new feature is analyzed
+and documented.
+
+For a full example of how to write a good commit message, check out
+https://github.com/sparkbox/how_to/tree/master/style/git