diff --git a/README.rst b/README.rst
index 37669a1..ff9d3c7 100644
--- a/README.rst
+++ b/README.rst
@@ -2,11 +2,29 @@ openssh
 =======
 Install and configure an openssh server.
 
-States
-------
+.. note::
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/topics/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
 ``openssh``
-    Installs the ``openssh`` package and service.
+-----------
+
+Installs the ``openssh`` package and service.
+
 ``openssh.config``
-    Installs the configuration file included in this formula (under "openssh/files").
+------------------
+
+Installs the configuration file included in this formula
+(under "openssh/files").
+
 ``openssh.banner``
-    Installs a banner that users see when SSH-ing in.
+------------------
+
+Installs a banner that users see when SSH-ing in.