summaryrefslogtreecommitdiffstats
path: root/docs/CONTRIBUTING.md
diff options
context:
space:
mode:
authorLibravatar sommerfeld <sommerfeld@sommerfeld.dev>2024-06-28 14:53:43 +0100
committerLibravatar sommerfeld <sommerfeld@sommerfeld.dev>2024-06-28 14:53:43 +0100
commitef34f0bb4798a0d1410fffc974f084e4c6cfb920 (patch)
tree927965d3de187e2af5d594e6018b635a416ef6fb /docs/CONTRIBUTING.md
downloadviewercount-ef34f0bb4798a0d1410fffc974f084e4c6cfb920.tar.gz
viewercount-ef34f0bb4798a0d1410fffc974f084e4c6cfb920.tar.bz2
viewercount-ef34f0bb4798a0d1410fffc974f084e4c6cfb920.zip
Initial commit
Diffstat (limited to 'docs/CONTRIBUTING.md')
-rw-r--r--docs/CONTRIBUTING.md27
1 files changed, 27 insertions, 0 deletions
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
new file mode 100644
index 0000000..e2d58ea
--- /dev/null
+++ b/docs/CONTRIBUTING.md
@@ -0,0 +1,27 @@
+# Contributing
+
+## How to contribute
+
+1. Fork repo and create a new topic branch
+2. Make changes
+3. Ensure it compiles and passes tests using
+
+```bash
+cargo build
+cargo test
+```
+
+4. Auto format the code using `rustfmt` or a tool that integrates it (such as
+ `rust-analyzer` or some IDE).
+5. Make small atomic compilable working commits. Do NOT use "Conventional
+ Commits" for the commit title. Instead just directly write what was changed
+without any prefixes. Write it in the imperative tense and use the
+["50/72" rule](https://stackoverflow.com/a/11993051)
+6. Push commits to the created topic branch in your repo.
+7. Open a PR, wait for review.
+
+## How to create a new Action
+
+Use the [telegram action](../src/actions/telegram.rs) as a template. You need to
+implement the `Action` trait for your action and add the necessary hooks in
+[actions/mod.rs](../src/actions/mod.rs).