From 2cb1950d38905d61237408d1088ce1e7f0c025b6 Mon Sep 17 00:00:00 2001
From: Forrest Alvarez <forrest.alvarez@gmail.com>
Date: Sat, 8 Feb 2014 06:03:40 +0000
Subject: [PATCH] Updates to the readme.

---
 README.rst | 50 +++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 49 insertions(+), 1 deletion(-)

diff --git a/README.rst b/README.rst
index bfdae84..832f822 100644
--- a/README.rst
+++ b/README.rst
@@ -1,4 +1,52 @@
+=====
 nginx
 =====
 
-Install `nginx` either by source or by package.
\ No newline at end of file
+Install nginx either by source or by package.
+
+.. note::
+
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/topics/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+``nginx``
+---------
+
+Runs the states to install nginx, configure the common files, and the users.
+
+``nginx.common``
+----------------
+
+Ensures standard nginx files are in place, and configures enabled sites.
+
+``nginx.luajit2``
+-----------------
+
+Installs luajit.
+
+``nginx.openresty``
+-------------------
+
+Installs openresty.
+
+``nginx.package``
+-----------------
+
+Installs the nginx package via package manager.
+
+``nginx.source``
+----------------
+
+Installs nginx via the source files.
+
+``nginx.users``
+---------------
+
+Installs apache utils, and configures nginx users specified in the pillar.