docs: refactor designate docs
diff --git a/docs/dns.md b/docs/dns.md
deleted file mode 100644
index 5141345..0000000
--- a/docs/dns.md
+++ /dev/null
@@ -1,57 +0,0 @@
-# DNS
-
-## PowerDNS
-
-### Pre-requisites
-
-You have to install a PowerDNS server first, this is outside the scope of this
-document.  You can review instructions on how to prepare the PowerDNS server
-through the [Designate](https://docs.openstack.org/designate/latest/admin/backends/pdns4.html)
-documentation.
-
-### Configuration
-
-You will need to configure your PowerDNS server to allow the Designate API to
-talk to it.  This is done by adding the following to your PowerDNS configuration
-into your inventory file.
-
-In this example, PowerDNS will be configured to validate if the DNS changes have
-been propagated to all DNS servers by hitting the PowerDNS backend.  It will
-use the virtual IP address of the cloud to request AXFRs.
-
-In this example, it's assumed that the PowerDNS server is running at `192.168.1.10`
-and reachable by the Kubernetes cluster using `secret123` as the token.
-
-!!! note
-
-    You will need to make sure you configure your Glue DNS records with your
-    registrar to point towards your PowerDNS instances (also frequently called
-    "registering nameservers").  This is out of the scope of this document.
-
-```yaml
-designate_pools: |
-  - name: default
-    description: Default PowerDNS Pool
-
-    ns_records:
-      - hostname: ns1.example.com.
-        priority: 1
-      - hostname: ns2.example.com.
-        priority: 2
-
-    nameservers:
-      - host: 192.168.1.10
-        port: 53
-
-    targets:
-      - type: pdns4
-        description: PowerDNS4 DNS Server
-        masters:
-          - host: "{{ keepalived_vip }}"
-            port: 5354
-        options:
-          host: 192.168.1.10
-          port: 53
-          api_endpoint: http://192.168.1.10:8081
-          api_token: secret123
-```
diff --git a/roles/designate/README.md b/roles/designate/README.md
index 16cc222..59a858b 100644
--- a/roles/designate/README.md
+++ b/roles/designate/README.md
@@ -1 +1,58 @@
 # `designate`
+
+## PowerDNS
+
+### Pre-requisites
+
+You have to install a PowerDNS server first, this is outside the scope of this
+document.  You can review instructions on how to prepare the PowerDNS server
+through the [Designate](https://docs.openstack.org/designate/latest/admin/backends/pdns4.html)
+documentation.
+
+### Configuration
+
+You will need to configure your PowerDNS server to allow the Designate API to
+talk to it.  This is done by adding the following to your PowerDNS configuration
+into your inventory file.
+
+In this example, PowerDNS will be configured to validate if the DNS changes have
+been propagated to all DNS servers by hitting the PowerDNS backend.  It will
+use the virtual IP address of the cloud to request AXFRs.
+
+In this example, it's assumed that the PowerDNS server is running at `192.168.1.10`
+and reachable by the Kubernetes cluster using `secret123` as the token.
+
+!!! note
+
+    You will need to make sure you configure your Glue DNS records with your
+    registrar to point towards your PowerDNS instances (also frequently called
+    "registering nameservers").  This is out of the scope of this document.
+
+```yaml
+designate_pools: |
+  - name: default
+    description: Default PowerDNS Pool
+
+    ns_records:
+      - hostname: ns1.example.com.
+        priority: 1
+      - hostname: ns2.example.com.
+        priority: 2
+
+    nameservers:
+      - host: 192.168.1.10
+        port: 53
+
+    targets:
+      - type: pdns4
+        description: PowerDNS4 DNS Server
+        masters:
+          - host: "{{ keepalived_vip }}"
+            port: 5354
+        options:
+          host: 192.168.1.10
+          port: 53
+          api_endpoint: http://192.168.1.10:8081
+          api_token: secret123
+```
+