Added instructions, closes #2981

README.md

@@ -133,6 +133,17 @@ install them all using:
 If you have `pandoc` installed, you can also generate an ePub with
 
     $ make epub
+
+*Provisionally* and on our way to the 2.0 version, this is how you build the documentation using [documentable](https://github.com/perl6/Documentable)
+
+	make assets
+	make init-highlights
+	documentable start -a -v --highlight
+
+You need to do this only the first time, or (for now) when you add new files.
+
+    documentable update
+
 
 ## nginx configuration