diff --git a/src/tests/README.md b/src/tests/README.md
index 8a856d6..046be7f 100644
--- a/src/tests/README.md
+++ b/src/tests/README.md
@@ -1 +1,9 @@
-TODO: write Amulet tests.
+# Overview
+
+This directory provides Amulet tests to verify basic deployment functionality
+from the perspective of this charm, its requirements and its features, as
+exercised in a subset of the full OpenStack deployment test bundle topology.
+
+For full details on functional testing of OpenStack charms please refer to
+the [functional testing](http://docs.openstack.org/developer/charm-guide/testing.html#functional-testing)
+section of the OpenStack Charm Guide.