diff --git a/README.rst b/README.rst
index 381849c..dcf846e 100644
--- a/README.rst
+++ b/README.rst
@@ -1,7 +1,26 @@
 postfix
 =======
 
-postfix
--------
+Formulas to set up and configure the Postfix mail transfer agent.
 
-Install and start postfix
+.. note::
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+
+``postfix``
+-----------
+
+Installs and starts postfix SMTP server
+
+``postfix.config``
+------------------
+
+Manages postfix main.cf configuration file