diff --git a/README.md b/README.md
index 4583bd7..d7995ac 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,11 @@
-This is taken from parts of org.oauth3-frontend and oauth3.js
+This is a WALNUT module representing the html package for oauth3.org.
 
-Needs a proper README. TODO cc / @coolaj86
+It must be installed to `/srv/walnut/packages/pages/org.oauth3`
+
+```bash
+git clone git@git.daplie.com:OAuth3/org.oauth3.git /srv/walnut/packages/pages/org.oauth3
+git checkout fs-nosql
+bash ./install.sh
+```
+
+This uses the OAuth3 JavaScript SDK `oauth3.js` as a subpackage in `/srv/walnut/packages/pages/org.oauth3/assets/org.oauth3`.
diff --git a/install.sh b/install.sh
index 2312b23..52ec282 100644
--- a/install.sh
+++ b/install.sh
@@ -1,5 +1,7 @@
 #!/bin/bash
 
+# git clone git@git.daplie.com:OAuth3/org.oauth3.git /srv/walnut/packages/pages/org.oauth3
+
 mkdir -p assets
 if [ -d ./assets/org.oauth3 ]; then
 	git clone git@git.daplie.com:Daplie/oauth3.js.git ./assets/org.oauth3
@@ -8,4 +10,5 @@ pushd ./assets/org.oauth3
   git checkout v1
   git pull
 popd
+
 bower install rsvp