diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..3108a3e
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,23 @@
+DevOps Portal
+=============
+
+The DevOps Portal provides dashboards and services to boost operational and
+support needs.
+
+Sample pillars
+~~~~~~~~~~~~~~
+
+The DevOps Portal supports only predefined set of services, add services into
+pillars to make them accessable from the portal. For example let's consider
+how to add a Jenkins service:
+
+.. code-block:: yaml
+
+    devops_portal:
+      config:
+        service:
+          jenkins:
+            endpoint:
+              address: 172.16.10.254
+              port: 8081
+              https: true