Update documentation examples

README.md

@@ -77,6 +77,8 @@ spec:
     # Name of a secret used to store the ACME account private key
     privateKeySecretRef:
       name: letsencrypt-staging
+    # Enable the HTTP-01 challenge provider
+    http-01: {}
     # ACME dns-01 provider configurations
     dns-01:
       # Here we define a list of DNS-01 providers that can solve DNS challenges

docs/api-types/issuer/spec.md

@@ -34,11 +34,25 @@ configuring credentials for a DNS provider.
 
 ### ACME issuer HTTP01 configuration
 
-The ACME issuer does not require any additional configuration in order to
+In order to allow HTTP01 challenges to be solved, we must enable the HTTP01
-support HTTP01 challenge validation. All valid ACME issuers are able to issue
+challenge provider on our Issuer resource. This can be done through setting the
-certificates validated with HTTP01 by creating or manipulating Ingress
+`http-01` field on the `issuer.spec.acme` stanza. Cert-manager will then create
-resources in the Kubernetes API server. The installed ingress controller will
+and manage Ingress rules in the Kubernetes API server in order to solve HTTP-01
-then configure routes to solve ACME challenges automatically.
+based challenges.
+
+```yaml
+apiVersion: certmanager.k8s.io
+kind: Issuer
+metadata:
+  name: example-issuer
+spec:
+  acme:
+    email: user@example.com
+    server: https://acme-staging.api.letsencrypt.org/directory
+    privateKeySecretRef:
+      name: example-issuer-account-key
+    http-01: {}
+```
 
 ### ACME issuer with no configured DNS providers
 

docs/examples/acme-issuer.yaml

@@ -11,6 +11,8 @@ spec:
     # Name of a secret used to store the ACME account private key
     privateKeySecretRef:
       name: letsncrypt-prod
+    # Enable the HTTP-01 challenge provider
+    http-01: {}
     # ACME dns-01 provider configurations
     dns-01:
       # Here we define a list of DNS-01 providers that can solve DNS challenges