diff --git a/README.md b/README.md
deleted file mode 100644
index e8f8a1e..0000000
--- a/README.md
+++ /dev/null
@@ -1,49 +0,0 @@
-# salt-formula-designate
-Designate provides DNSaaS services for OpenStack
-## Sample pillars
-```yaml
-  designate:
-    server:
-      database:
-        host: ${_param:database_vip_address}
-      notification: true
-      message_queue:
-        members:
-          - host: ${_param:messaging_node01_address}
-          - host: ${_param:messaging_node02_address}
-          - host: ${_param:messaging_node03_address}
-      pool:
-        pool_id: cae73b6f-95eb-4a7d-a567-099ae6176e08
-        nameservers:
-          - uuid: 690d7bc8-811b-404c-abcc-9cec54d87092
-            host: ${_param:cluster_node01_address}
-            port: 53
-          - uuid: bc5ddcf0-8d95-4f87-b435-9ff831a4a14c
-            host: ${_param:cluster_node02_address}
-            port: 53
-          - uuid: a43d5375-a5ec-4077-8c87-ec0b08fa3bd1
-            host: ${_param:cluster_node03_address}
-            port: 53
-        targets:
-          uuid: f26e0b32-736f-4f0a-831b-039a415c481e
-          options: 'port: 53, host: 127.0.0.1'
-          masters: 127.0.0.1:5354
-          type:  bind9
-```
-## Usage
-Create server
-```bash
-designate server-create --name ns.example.com.
-```
-Create domain
-```bash
-designate domain-create --name example.com. --email mail@example.com
-```
-Create record
-```bash
-designate record-create example.com. --name test.example.com. --type A --data 10.2.14.15
-```
-Test it
-```bash
-dig @127.0.0.1 test.example.com.
-```
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..b7717d8
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,61 @@
+salt-formula-designate
+======================
+
+Designate provides DNSaaS services for OpenStack ## Sample pillars
+
+.. code:: yaml
+
+      designate:
+        server:
+          database:
+            host: ${_param:database_vip_address}
+          notification: true
+          message_queue:
+            members:
+              - host: ${_param:messaging_node01_address}
+              - host: ${_param:messaging_node02_address}
+              - host: ${_param:messaging_node03_address}
+          pool:
+            pool_id: cae73b6f-95eb-4a7d-a567-099ae6176e08
+            nameservers:
+              - uuid: 690d7bc8-811b-404c-abcc-9cec54d87092
+                host: ${_param:cluster_node01_address}
+                port: 53
+              - uuid: bc5ddcf0-8d95-4f87-b435-9ff831a4a14c
+                host: ${_param:cluster_node02_address}
+                port: 53
+              - uuid: a43d5375-a5ec-4077-8c87-ec0b08fa3bd1
+                host: ${_param:cluster_node03_address}
+                port: 53
+            targets:
+              uuid: f26e0b32-736f-4f0a-831b-039a415c481e
+              options: 'port: 53, host: 127.0.0.1'
+              masters: 127.0.0.1:5354
+              type:  bind9
+
+Usage
+-----
+
+Create server
+
+.. code:: bash
+
+    designate server-create --name ns.example.com.
+
+Create domain
+
+.. code:: bash
+
+    designate domain-create --name example.com. --email mail@example.com
+
+Create record
+
+.. code:: bash
+
+    designate record-create example.com. --name test.example.com. --type A --data 10.2.14.15
+
+Test it
+
+.. code:: bash
+
+    dig @127.0.0.1 test.example.com.
diff --git a/debian/copyright b/debian/copyright
index 6ebcd98..7051ee2 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -1,6 +1,6 @@
 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Upstream-Name: salt-formula-designate
-Upstream-Contact: 
+Upstream-Contact:
 Source: https://github.com/Mirantis/salt-formula-designate
 
 Files: *
diff --git a/debian/docs b/debian/docs
index d585829..503f917 100644
--- a/debian/docs
+++ b/debian/docs
@@ -1,3 +1,2 @@
 README.rst
-CHANGELOG.rst
 VERSION