diff --git a/docs/acme-cert.yaml b/docs/acme-cert.yaml
index bda41f485..dcb4f3514 100644
--- a/docs/acme-cert.yaml
+++ b/docs/acme-cert.yaml
@@ -1,37 +1,50 @@
+## Example Certificate that uses nginx ingress to validate requests
 apiVersion: certmanager.k8s.io/v1alpha1
 kind: Certificate
 metadata:
-  name: certmanager-k8s-co
+  name: cm-http-nginx-k8s-group
 spec:
-  secretName: certmanager-k8s-co
+  secretName: cm-http-nginx-k8s-group
   issuer: letsencrypt-staging
   domains:
-  - certmanager.k8s.co
+  - cm-http-nginx.k8s.group
   acme:
     config:
     - domains:
-      - certmanager.k8s.co
+      - cm-http-nginx.k8s.group
       http-01:
-        # note: using an ingress doesn't currently work
-        ingress: certmanager-k8s-co
-status:
-  acme: {}
----
-apiVersion: certmanager.k8s.io/v1alpha1
-kind: Certificate
-metadata:
-  name: certmanager-k8s-co
-spec:
-  secretName: certmanager-k8s-co
-  issuer: letsencrypt-staging
-  domains:
-  - certmanager2.k8s.co
-  acme:
-    config:
-    - domains:
-      - certmanager.k8s.co
-      http-01:
-        # note: using an ingress class doesn't currently work
         ingressClass: nginx
-status:
-  acme: {}
+---
+## Example Certificate that uses gce ingress to validate requests
+apiVersion: certmanager.k8s.io/v1alpha1
+kind: Certificate
+metadata:
+  name: cm-http-gce-k8s-group
+spec:
+  secretName: cm-http-gce-k8s-group
+  issuer: letsencrypt-staging
+  domains:
+  - cm-http-gce.k8s.group
+  acme:
+    config:
+    - domains:
+      - cm-http-gce.k8s.group
+      http-01:
+        ingressName: my-existing-ingress
+---
+## Example Certificate that uses clouddns to validate requests
+apiVersion: certmanager.k8s.io/v1alpha1
+kind: Certificate
+metadata:
+  name: cm-dns-clouddns-k8s-group
+spec:
+  secretName: cm-dns-clouddns-k8s-group
+  issuer: letsencrypt-staging
+  domains:
+  - cm-dns-clouddns.k8s.group
+  acme:
+    config:
+    - domains:
+      - cm-dns-clouddns.k8s.group
+      dns-01:
+        provider: clouddns
diff --git a/docs/acme-issuer.yaml b/docs/acme-issuer.yaml
index 5b67fee50..af39ca707 100644
--- a/docs/acme-issuer.yaml
+++ b/docs/acme-issuer.yaml
@@ -10,9 +10,24 @@ spec:
     # dns-01 config options
     dns-01:
       providers:
-      - name: clouddns-staging
+      - name: clouddns
         clouddns:
-          serviceAccount: service-account-secret-staging
-          project: googles-corp-project
-status:
-  ready: true
\ No newline at end of file
+          serviceAccount: clouddns-service-account
+          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: clouddns-service-account
+          project: jetstack-sandbox