Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..e0c2227
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,46 @@
+
+===========
+Git formula
+===========
+
+Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
+
+Sample pillars
+==============
+
+.. code-block:: yaml
+
+Simplest GIT setup
+
+ git:
+ client:
+ enabled: true
+
+GIT with user setup
+
+.. code-block:: yaml
+
+ git:
+ client:
+ enabled: true
+ user:
+ - user:
+ name: jdoe
+ email: j@doe.com
+
+Reclass with GIT with user setup
+
+.. code-block:: yaml
+
+ git:
+ client:
+ enabled: true
+ user:
+ - user: ${linux:system:user:jdoe}
+
+Read more
+=========
+
+* http://git-scm.com/
+* http://git-scm.com/book/en/Customizing-Git-Git-Configuration
+* https://github.com/nesi/puppet-git/tree/master/manifests