aboutsummaryrefslogtreecommitdiff
path: root/CONTRIBUTING.md
diff options
context:
space:
mode:
authoradrien <adrien@luxeylab.net>2021-09-11 16:34:03 +0200
committeradrien <adrien@luxeylab.net>2021-09-11 16:34:03 +0200
commitf7200709059c00e74cb25f5d8967d81a834f6bb8 (patch)
treedab43a23074cbdf41f2ce3740532957f604af779 /CONTRIBUTING.md
parentfa25c54e47decf9f323ba0c614f4d9de106626d5 (diff)
downloaddiplonat-f7200709059c00e74cb25f5d8967d81a834f6bb8.tar.gz
diplonat-f7200709059c00e74cb25f5d8967d81a834f6bb8.zip
added rustfmt: a rustfmt.toml file diescribing syntax (soft tabs of 2 spaces), a CONTRIBUTING.md file to explain how to use rustfmt, a .drone.yml file to add code style checks in CI, 2 lines in README.md to present CONTRIBUTING.md, and applied rustfmt on the source
Diffstat (limited to 'CONTRIBUTING.md')
-rw-r--r--CONTRIBUTING.md34
1 files changed, 34 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..f8de6cc
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,34 @@
+# Contributing to Diplonat
+
+## Development guidelines
+
+### Code formatting
+
+[Our CI pipeline](./.drone.yml) features a verification of the code format, using [rustfmt](https://github.com/rust-lang/rustfmt).
+
+#### Installing rustfmt
+
+You can run `rustfmt` with Rust 1.24 and above.
+
+To install:
+
+```
+rustup component add rustfmt
+```
+
+#### Usage
+
+To run on Diplonat, launch the following in the root directory:
+
+```
+cargo fmt --all
+```
+
+This will format the whole repository using the settigs defined in [`.rustfmt.toml`](./.rustfmt.toml): soft tabs of 2 spaces.
+
+#### Auto-format code
+
+You can automate formatting in a number of ways:
+
+* [Setup your IDE to use `rustfmt`](https://github.com/rust-lang/rustfmt#running-rustfmt-from-your-editor).
+* Setup a git hook to run `rustfmt` before each commit.