summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Mueller <deso@posteo.net>2019-01-01 15:10:40 -0800
committerDaniel Mueller <deso@posteo.net>2019-01-01 15:10:40 -0800
commita98e417c3373a91fc12df8e483222f67dfac5335 (patch)
treecad98d4ac09a03b7038ccabe2638f1fa7ca59865
parentd50039f758cc5520b30a0ca65c8d8f77cef949cd (diff)
downloadnitrocli-a98e417c3373a91fc12df8e483222f67dfac5335.tar.gz
nitrocli-a98e417c3373a91fc12df8e483222f67dfac5335.tar.bz2
Add file detailing some general rules for contribution to the project
This change adds a new file, CONTRIBUTING.md, that details some generally applicable rules for the contribution to this project. It also links this file from the README.
-rw-r--r--nitrocli/README.md7
-rw-r--r--nitrocli/doc/CONTRIBUTING.md23
2 files changed, 30 insertions, 0 deletions
diff --git a/nitrocli/README.md b/nitrocli/README.md
index e0efab9..308fbf2 100644
--- a/nitrocli/README.md
+++ b/nitrocli/README.md
@@ -101,6 +101,13 @@ It is recommended that the resulting executable be installed in a
directory accessible via the `PATH` environment variable.
+Contributing
+------------
+
+Contributions are generally welcome. Please follow the guidelines
+outlined in [CONTRIBUTING.md](doc/CONTRIBUTING.md).
+
+
Acknowledgments
---------------
diff --git a/nitrocli/doc/CONTRIBUTING.md b/nitrocli/doc/CONTRIBUTING.md
new file mode 100644
index 0000000..3ebdfce
--- /dev/null
+++ b/nitrocli/doc/CONTRIBUTING.md
@@ -0,0 +1,23 @@
+The following rules generally apply for pull requests and code changes:
+
+**Submit Pull Requests to the `devel` branch**
+
+The `devel` branch is where experimental features reside. After some
+soak time they may be ported over to `master` and a release will be cut
+that includes them.
+
+**Keep documentation up-to-date**
+
+Please make an effort to keep the documentation up-to-date to the extent
+possible and necessary for the change at hand. That includes adjusting
+the [README](../README.md) and [`man` page](nitrocli.1) as well as
+regenerating the PDF rendered version of the latter by running `make
+doc`.
+
+**Blend with existing patterns and style**
+
+To keep the code as consistent as possible, please try not to diverge
+from the existing style used in a file. Specifically for Rust source
+code, use [`rustfmt`](https://github.com/rust-lang/rustfmt) and
+[`clippy`](https://github.com/rust-lang/rust-clippy) to achieve a
+minimum level of consistency and prevent known bugs, respectively.