Merge pull request #19 from gravyboat/master

Updated structure of readme, bumped License to 2014.

LICENSE

@@ -1,4 +1,4 @@
-   Copyright (c) 2013 Salt Stack Formulas
+   Copyright (c) 2014 Salt Stack Formulas
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.rst

@@ -1,4 +1,29 @@
+=====
 users
 =====
 
-Configure users via pillar
+Formula to configure users via pillar.
+
+
+.. note::
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/topics/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+``users``
+---------
+
+Configure a user's home directory, group, the user itself, secondary groups,
+and associated keys. Also configures sudo access, and absent users.
+
+``users.sudo``
+--------------
+
+Ensures the sudo group exists, the sudo package is installed and the sudo file
+is configured.