diff --git a/docs/acme-issuer.yaml b/docs/acme-issuer.yaml
index c7d07b9d5..7a62511bb 100644
--- a/docs/acme-issuer.yaml
+++ b/docs/acme-issuer.yaml
@@ -1,37 +1,35 @@
-apiVersion: certmanager.k8s.io/v1alpha1
 kind: Issuer
 metadata:
   name: letsencrypt-staging
 spec:
   acme:
+    # The ACME server URL
     server: https://acme-staging.api.letsencrypt.org/directory
-    email: james@jetstack.io
-    privateKey: le-staging
-    # dns-01 config options
+    # Email address used for ACME registration
+    email: user@example.com
+    # Name of a secret used to store the ACME account private key
+    privateKey: letsncrypt-staging
+    # ACME dns-01 provider configurations
     dns-01:
+      # Here we define a list of DNS-01 providers that can solve DNS challenges
       providers:
+      # We define a provider named 'clouddns', with configuration for the
+      # clouddns challenge provider.
       - name: clouddns
         clouddns:
+          # A secretKeyRef to a the google cloud json service account
           serviceAccount:
             name: clouddns-service-account
             key: service-account.json
-          project: jetstack-sandbox
----
-apiVersion: certmanager.k8s.io/v1alpha1
-kind: Issuer
-metadata:
-  name: letsencrypt-prod
-spec:
-  acme:
-    server: https://acme-v01.api.letsencrypt.org/directory
-    email: james@jetstack.io
-    privateKey: le-prod
-    # dns-01 config options
-    dns-01:
-      providers:
-      - name: clouddns
-        clouddns:
-          serviceAccount:
-            name: clouddns-service-account
-            key: service-account.json
-          project: jetstack-sandbox
+          # The project in which to update the DNS zone
+          project: gcloud-project
+      # We define a provider named 'cloudflare', with configuration for the
+      # cloudflare challenge provider.
+      - name: cloudflare
+        cloudflare:
+          # A secretKeyRef to a the cloudflare api key
+          apiKey:
+            name: cloudflare-config
+            key: api-key
+          # The cloudflare user account email
+          email: cloudflare-user@example.com