diff --git a/kernel-rs/README.md b/kernel-rs/README.md
index 6f7bfaf4..47f4d9ee 100644
--- a/kernel-rs/README.md
+++ b/kernel-rs/README.md
@@ -2,18 +2,17 @@ Kernel from scratch (KFS) series of projects at Ecole 42 !
 
 ### [documentation](https://jzck.github.io/kernel/bluesnow/index.html)
 
-### dependencies
+# building
 
   - `nasm` compiles the bootcode
   - `ld` links the bootcode and rust binary
   - `grub-mkrescue` builds the iso
   - `xargo` builds rust code
-  - `qemu` runs the iso
 
 See `.travis.yml` to get an ubuntu environment ready  
 on archlinux `pacman -S rustup make grub xorriso mtools binutils gcc qemu`
 
-### rust setup
+#### rust setup
 
 ```
 rustup override add nightly
@@ -21,17 +20,17 @@ rustup component add rust-src
 cargo install xargo
 ```
 
-### running
+# running
 
-`make iso` generate the iso
-`make qemu` runs the OS in a tmux window with `qemu` + `gdb`  
+  - `make iso` builds a bootable iso with grub
+  - `make qemu` runs the iso, `make qemu-reload` after a re-build
 
-### todo
+# todo
 
   - remove assembly for a pure rust entry point
   - replace grub with something lighter
 
-### inspiration
+# inspiration
 
   - [wiki.osdev.org](https://wiki.osdev.org) is a fucking goldmine
   - [Phil Opperman's "Writing an OS in rust"](https://os.phil-opp.com/)