diff --git a/README.rst b/README.rst
index 35cc392..a7f9cc3 100644
--- a/README.rst
+++ b/README.rst
@@ -1,23 +1,28 @@
 
-==================================
-gerrit
-==================================
+======
+Gerrit
+======
 
-Service gerrit description
+Gerrit provides web based code review and repository management for the Git version control system.
 
 Sample pillars
 ==============
 
-Single gerrit service
+Sipmple gerrit service
 
 .. code-block:: yaml
 
     gerrit:
       server:
         enabled: true
-        version: icehouse
+        source:
+          engine: http
+          address: https://gerrit-ci.gerritforge.com/job/Gerrit-stable-2.13/20/artifact/buck-out/gen/gerrit.war
+          hash: 2e17064b8742c4622815593ec496c571
 
 Read more
 =========
 
-* links
+* https://www.gerritcodereview.com/
+* https://github.com/openstack-infra/puppet-gerrit/
+* https://gerrit-ci.gerritforge.com/