]> git.ipfire.org Git - thirdparty/babel.git/commitdiff
Add CONTRIBUTING 245/head
authorLasse Schuirmann <lasse.schuirmann@gmail.com>
Tue, 22 Sep 2015 21:21:20 +0000 (23:21 +0200)
committerLasse Schuirmann <lasse.schuirmann@gmail.com>
Tue, 22 Sep 2015 21:22:40 +0000 (23:22 +0200)
This finally fixes our review process and gives users a bug template.

CONTRIBUTING.md [new file with mode: 0644]

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644 (file)
index 0000000..2fa0a65
--- /dev/null
@@ -0,0 +1,52 @@
+# Babel Contribution Guidelines
+
+Welcome to Babel! These guidelines will give you a short overview over how we
+handle issues and PRs in this repository. Note that they are preliminary and
+still need proper phrasing - if you'd like to help - be sure to make a PR.
+
+Please know that we do appreciate all contributions - bug reports as well as
+Pull Requests.
+
+## Filing Issues
+
+When filing an issue, please use this template:
+
+```
+# Overview Description
+
+# Steps to Reproduce
+
+1.
+2.
+3.
+
+# Actual Results
+
+# Expected Results
+
+# Reproducibility
+
+# Additional Information:
+
+```
+
+## PR Merge Criteria
+
+For a PR to be merged, the following statements must hold true:
+
+- All CI services pass. (Windows build, linux build, sufficient test coverage.)
+- All commits must have been reviewed and approved by a babel maintainer who is
+  not the author of the PR. Commits shall comply to the "Good Commits" standards
+  outlined below.
+
+## Correcting PRs
+
+Rebasing PRs is preferred over merging master into the source branches again
+and again cluttering our history. If a reviewer has suggestions, the commit
+shall be amended so the history is not cluttered by "fixup commits".
+
+## Writing Good Commits
+
+Please see
+http://coala.readthedocs.org/en/latest/Getting_Involved/Writing_Good_Commits/
+for guidelines on how to write good commits and proper commit messages.