diff --git a/README.md b/README.md
index 4a876ca3..724c4aca 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ Please use this repository to raise issues and submit pull requests:
 https://github.com/xsf/xeps/issues
 https://github.com/xsf/xeps/pulls
 
-For in-depth technical discussion, please post to the standards@xmpp.org 
+For in-depth technical discussion, please post to the standards@xmpp.org
 email list:
 
 http://mail.jabber.org/mailman/listinfo/standards
@@ -23,7 +23,18 @@ page:
 
 http://xmpp.org/xmpp-protocols/xmpp-extensions/submitting-a-xep/
 
-[XEP-0001: XMPP Extension Protocols](http://xmpp.org/extensions/xep-0001.html) defines the standards process followed by the XMPP Standards Foundation.
+[XEP-0001: XMPP Extension Protocols](http://xmpp.org/extensions/xep-0001.html)
+defines the standards process followed by the XMPP Standards Foundation.
 
-Thanks!
+Building XEPs
+-------------
 
+To build a single XEP as HTML simply run:
+
+    make xep-xxxx
+
+To change the output directory, set the variable `OUTDIR`, eg.
+
+    OUTDIR=/tmp/xeps make all
+
+For more information try `make help`.