diff --git a/src/README.md b/src/README.md
index 02b5ef0..e5d6813 100644
--- a/src/README.md
+++ b/src/README.md
@@ -1 +1,17 @@
-# Write me.
+# Overview
+
+This charm provides a bind server to store DNS records generated by designate.
+
+# Usage
+
+designate-bind relies on designate charm.
+
+    juju deploy designate-bind
+    juju deploy designate
+    juju add-relation designate designate-bind
+
+# Bugs
+
+Please report bugs on [Launchpad](https://bugs.launchpad.net/charm-designate-bind/+filebug).
+
+For general questions please refer to the OpenStack [Charm Guide](http://docs.openstack.org/developer/charm-guide/).