diff options
author | Michael Stapelberg <michael@stapelberg.de> | 2016-02-19 18:41:30 +0100 |
---|---|---|
committer | Michael Stapelberg <michael@stapelberg.de> | 2016-02-19 18:41:30 +0100 |
commit | fe5e7b0c81855a18dc3a4556e2964764bb6cbd2b (patch) | |
tree | 7c59283fcd1a44af33a0b7ea22c8dfdc872f15dc /.github | |
parent | f63701ed098414a61bf4d78d443194f94092b5ff (diff) | |
download | i3-fe5e7b0c81855a18dc3a4556e2964764bb6cbd2b.tar.gz i3-fe5e7b0c81855a18dc3a4556e2964764bb6cbd2b.zip |
move CONTRIBUTING.md to .github/ directory
See https://github.com/blog/2111-issue-and-pull-request-templates
Diffstat (limited to '.github')
-rw-r--r-- | .github/CONTRIBUTING.md | 32 |
1 files changed, 32 insertions, 0 deletions
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md new file mode 100644 index 00000000..474355ad --- /dev/null +++ b/.github/CONTRIBUTING.md @@ -0,0 +1,32 @@ +# Contributing + +## i3status/i3lock bug reports and feature requests + +Note that bug reports and feature requests for related projects should be filed in the corresponding repositories for [i3status](https://github.com/i3/i3status) and [i3lock](https://github.com/i3/i3lock). + +## i3 bug reports and feature requests + +1. Read the [debugging instructions](http://i3wm.org/docs/debugging.html). +2. Make sure you include a link to your logfile in your report (section 3). +3. Make sure you include the i3 version number in your report (section 1). +4. Please be aware that we cannot support compatibility issues with + closed-source software, as digging into compatibility problems without + having access to the source code is too time-consuming. Additionally, + experience has shown that often, the software in question is responsible for + the issue. Please raise an issue with the software in question, not i3. + +## Pull requests + +* Before sending a pull request for new features, please check with us that the + feature is something we want to see in i3 by opening an issue which has + ”feature request” or ”enhancement” in its title. +* Use the `next` branch for developing and sending your pull request. +* Use `clang-format` to format your code. +* Run the [testsuite](http://i3wm.org/docs/testsuite.html) + +## Finding something to do + +* Find a [reproducible bug](https://github.com/i3/i3/issues?utf8=%E2%9C%93&q=is%3Aopen+label%3Areproducible+label%3Abug+) from the issue tracker. These issues have been reviewed and confirmed by a project contributor. +* Find an [accepted enhancement](https://github.com/i3/i3/issues?utf8=%E2%9C%93&q=is%3Aopen+label%3Aaccepted+label%3Aenhancement) from the issue tracker. These have been approved and are ok to start working on. + +There's a very good [overview of the codebase](http://i3wm.org/docs/hacking-howto.html) available to get you started. |