diff --git a/scripts/README b/scripts/README
new file mode 100644
index 00000000..b9285412
--- /dev/null
+++ b/scripts/README
@@ -0,0 +1,10 @@
+Requirements:
+ - docutils (for converting RST to HTML) 
+
+To generate the complete specification along with supporting documentation, run:
+    python gendoc.py
+
+The output of this will be inside the "gen" folder.
+
+Matrix.org only ("gen" folder has matrix.org tweaked pages):
+    ./matrix-org-gendoc.sh /includes/nav.html
diff --git a/scripts/matrx-org-gendoc.sh b/scripts/matrix-org-gendoc.sh
similarity index 100%
rename from scripts/matrx-org-gendoc.sh
rename to scripts/matrix-org-gendoc.sh