diff --git a/cloud-image/readme.txt b/cloud-image/readme.txt
new file mode 100644
index 00000000..a979aa08
--- /dev/null
+++ b/cloud-image/readme.txt
@@ -0,0 +1,10 @@
+create_image.py:
+
+- uses fabric, which doesn't support Python 3
+
+- prompts for Rackspace credentials if environment variables not set
+  - see .novarc for example env variables
+    - note that the novaclient library uses the Rackspace password and -not-
+      the API key
+
+- use '--help' for help with arguments