docfixes
diff --git a/README.rst b/README.rst
index 4e914ed..55c13f8 100644
--- a/README.rst
+++ b/README.rst
@@ -1,9 +1,15 @@
-# rsync
+=============
+rsync Formula
+=============
-rsync is an open source utility that provides fast incremental file transfer.
+rsync is an open source utility that provides fast incremental file transfer.
-## Sample pillar
+
+Sample Metadata
+===============
+
+.. code-block:: yaml
rsync:
server:
@@ -17,11 +23,14 @@
read_only: False
timeout: 300
-## Read more
+
+References
+==========
* http://rsync.samba.org/
* http://www.togaware.com/linux/survivor/Rsync_Server.html
+
Documentation and Bugs
======================