diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..1bc773c
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,32 @@
+
+================
+openscap formula
+================
+
+Openscap is used to install openscap utils.
+
+Sample pillars
+==============
+
+.. code-block:: yaml
+
+   parameters:
+     openscap:
+       service:
+         enabled: True
+       upload:
+         cloud_name: ${_param:cluster_domain}
+         api_url: http://8.8.8.8:12345/
+       tailoring:
+         id:
+           profile: xccdf_org.customer.content_profile_default
+           extends: xccdf_org.mirantis.content_profile_default
+           values:
+             first_value: First
+             second_value: 2
+             external_ip_address: ${_param:single_address}
+
+Read more
+=========
+
+* https://www.open-scap.org/