diff --git a/README.md b/README.md
index 35a6c5b..765d20d 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,22 @@
 # Quick start
 
-- install `mr` (`apt-get install mr`)
-- echo $(pwd)/.mrconfig >> ~/.mrtrust
-- mr checkout
+To clone all the sub-projects:
+
+```
+$ install `mr` (`apt-get install mr`)
+$ echo $(pwd)/.mrconfig >> ~/.mrtrust
+$ mr checkout
+```
+
+To build packages:
+
+```
+$ make
+```
+
+To add a new subproject:
+
+- edit `.mrconfig` and add a new section for the project (base it on the
+  existing sections for the existing subprojects)
+- add a new .spec.in file for the project in rpm/$PROJECT.spec.in
+- that's all
--
libgit2 0.21.2