diff --git a/test/readme.md b/test/readme.md
new file mode 100644
index 0000000000..0e12989e3e
--- /dev/null
+++ b/test/readme.md
@@ -0,0 +1,23 @@
+Included in this directory
+--------------------------
+
+- ol.html - the web page used to run the test suite.
+
+- spec - includes the OpenLayers test/spec files.
+
+- jasmine-1.2.0 - includes the Jasmine Testing Framework.
+  https://github.com/pivotal/jasmine
+
+- jasmine-extensions.js - includes OpenLayers-specific extensions to Jasmine.
+
+- phantom-jasmine - a PhantomJS script and a console reporter to for headless
+  testing. Comes from https://github.com/jcarver989/phantom-jasmine.
+
+Run the test suite with PhantomJS
+---------------------------------
+
+With PhantomJS installed, and assuming phantomjs is in the PATH:
+
+    $ phantomjs phantom-jasmine/run_jasmine_test.coffee ol.html
+
+(Works with PhantomJS 1.6.1, untested with other versions.)