diff --git a/CHANGELOG.rst b/CHANGELOG.rst
new file mode 100644
index 0000000..3408358
--- /dev/null
+++ b/CHANGELOG.rst
@@ -0,0 +1,6 @@
+baremetal-simulator formula
+===========================
+
+0.1 (2017-07-11)
+
+- Initial formula setup
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..c663c12
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,16 @@
+
+===================
+baremetal-simulator
+===================
+
+Formula to simulate HW nodes by libvirt VMs and virtualbmc
+
+Sample pillar
+==============
+
+Enable baremetal-simulator
+
+.. code-block:: yaml
+
+  barmeetal_simulator:
+    enabled: true