diff --git a/README.md b/README.md
index 9e6e67f..197b6db 100644
--- a/README.md
+++ b/README.md
@@ -30,3 +30,18 @@ $ mcl
 ```
 
 for full usage, see `mcl -h`
+
+## installation
+install using cargo.
+```sh
+cargo install --git https://git.ozzy.top/ozzy/mcl
+```
+
+## building
+build using `just`. see available recipes by running `just` or `just --list`.
+
+## contribution
+before contributing, make sure all tests pass. also make sure to add tests for any new features.
+```sh
+just test
+```