diff --git a/README b/README
deleted file mode 100644
index e69de29bb2d1d6434b8b29ae775ad8c2e48c5391..0000000000000000000000000000000000000000
diff --git a/README.md b/README.md
new file mode 100644
index 0000000000000000000000000000000000000000..6221c85c45324ac5227248e3845dc4957d3e9f68
--- /dev/null
+++ b/README.md
@@ -0,0 +1,10 @@
+This is an exploration of the distributed identity system described here:
+https://wiki.mozilla.org/Labs/Identity/VerifiedEmailProtocol
+
+Getting started:
+
+1. install node.js: http://nodejs.org/
+2. install the Connect framework: http://senchalabs.github.com/connect/
+3. run the top level `run.js` script
+4. visit the demo application ('rp') in your web browser (url output on the console at runtime)␁
+