Updated README with these changes moved Pillar examples into pillar file

README.rst

@@ -1,18 +1,23 @@
 apache
 ======
-DEPENDENCIES:
-  These salt-states are required:
 
-	1) apt
+Formulas to set up and configure the Apache HTTP server
 
-POSSIBLE DEPENDENCIES
-  These salt-states may be required depending on what your doing:
+.. note::
 
-	1) php
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/topics/conventions/formulas.html>`_.
 
-ORDERING:
+Available states
+----------------
 
-The ordering of the states for apache falls into block ranges which are:
+``apache``
+    Installs the Apache package and starts the service.
+``apache.debian_full``
+    Installs and configures Apache on Debian and Ubuntu systems.
+
+    These states are ordered using the ``order`` declaration. Different stages
+    are divided into the following number ranges:
 
     1)  apache will use 1-500 for ordering
     2)  apache will reserve 1  -100 as unused
@@ -25,17 +30,11 @@ The ordering of the states for apache falls into block ranges which are:
     9)  apache WILL reserve 451-460 for service.running
     10) apache will reserve 461-500 for cmd requiring operational services
 
-PILLARS:
+    Dependencies:
 
-	1)  No pillar data is required
-	2)  Full pillar structure:
+    * `apt <https://github.com/saltstack-formulas/apt-formula>`_
 
-apache:
-  php-ini: 'salt://path/to/file/php.ini'
-  register-site:
-    {{UNQIUE}}:
-      name: 'my name'
-      path: 'salt://path/to/sites-available/conf/file'
-      state: 'enabled'
+    Optional dependencies:
+
+    1) `php <https://github.com/saltstack-formulas/php-formula>`_
 
-	3)  UNIQUE can be any name as an array index, and you can duplicate this section

pillar.example

@@ -0,0 +1,10 @@
+# Example for the apache.debian_full formula:
+
+apache:
+  php-ini: 'salt://path/to/file/php.ini'
+  register-site:
+    # any name as an array index, and you can duplicate this section
+    {{UNQIUE}}:
+      name: 'my name'
+      path: 'salt://path/to/sites-available/conf/file'
+      state: 'enabled'