1 files changed, 28 insertions, 0 deletions
diff --git a/README.md b/README.md
index 113f390..bbc4f16 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,34 @@ A simple keyboard driven stacking window manager. **This wm still does
 not work nor it's intended for a standard use**. Although one can play
 around with it.
 
+## Building
+
+First one you need to install the [Rust compiler](www.rust-lang.org). The
+code is intended to work on rust stable. Once you installed rust, run the
+following snippet:
+
+    cargo build --release
+
+For developing, you might want to run [clippy](https://github.com/Manishearth/rust-clippy)
+and it's needed to build against rust nightly. Rustup makes this easy.
+just download the nightly channel or use [rustup](https://rustup.rs)
+and run:
+
+    # with cargo nightly
+    cargo build --features=clippy
+    # with rustup
+    rustup run nightly cargo build --features=clippy
+
+## Testing
+
+There's an interesting tool (called `Xephyr`) to test windows managers
+without the need to start a new session.
+This is what I run to test it.
+
+    Xephyr :1 &
+    export DISPLAY=:1
+    /path/to/dotwm/target/debug/dotwm
+
 ## Intended features.
 
 * A client/server model.