diff --git a/docs/guides/ingress/configuration/loadbalance-algorithm.md b/docs/guides/ingress/configuration/loadbalance-algorithm.md
index a2f8a7a5a..e1542c9cc 100644
--- a/docs/guides/ingress/configuration/loadbalance-algorithm.md
+++ b/docs/guides/ingress/configuration/loadbalance-algorithm.md
@@ -25,7 +25,7 @@ metadata:
   name: test-ingress
   namespace: demo
 spec:
-  backend:
+  defaultBackend:
     service:
       name: test-server
       port:
diff --git a/docs/guides/ingress/http/external-svc.md b/docs/guides/ingress/http/external-svc.md
index 5267d9c52..336cb048f 100644
--- a/docs/guides/ingress/http/external-svc.md
+++ b/docs/guides/ingress/http/external-svc.md
@@ -59,7 +59,7 @@ metadata:
   name: test-ings-rhvulnlb
   namespace: default
 spec:
-  backend:
+  defaultBackend:
     service:
       name: external-ip
       port:
@@ -98,14 +98,14 @@ spec:
 
 If this service is used in ingress, the traffic will forward to google.com's address.
 
-```
+```yaml
 apiVersion: voyager.appscode.com/v1
 kind: Ingress
 metadata:
   name: test-ings-rhvulnlb
   namespace: default
 spec:
-  backend:
+  defaultBackend:
     service:
       name: external-ns
       port:
@@ -130,6 +130,7 @@ spec:
 #### Default redirect
 If No BackendRules are configured for the endpoint, Voyager will configure HAProxy to redirect traffic to provided domain and port.
 The redirect code will be 301 (permanent redirect). Scheme (http or https) used by endpoint is preserved on redirect.
+
 ```
 backend:
   service:
@@ -145,6 +146,7 @@ http-request redirect location http[s]://{{e.ExternalName}}:{{ e.Port }} code 30
 ```
 
 #### Backend Rule
+
 If Backendrules are configured, Voyager will not auto generate any redirect rule. This allows users to use full spectrum of HTTP redirection options available in HAProxy. To learn about these option, consult [HAProxy documentation](https://www.haproxy.com/doc/aloha/7.0/haproxy/http_redirection.html#redirection-examples).
 
 ```
diff --git a/docs/guides/ingress/http/http2.md b/docs/guides/ingress/http/http2.md
index 62df612d1..7d4a375e5 100644
--- a/docs/guides/ingress/http/http2.md
+++ b/docs/guides/ingress/http/http2.md
@@ -32,9 +32,7 @@ spec:
   tls:
   - hosts:
     - host.example.com
-    ref:
-      kind: Secret
-      name: tls-host
+    secretName: tls-host
   rules:
   - host: host.example.com
     http:
diff --git a/docs/guides/ingress/http/single-service.md b/docs/guides/ingress/http/single-service.md
index 343aad456..480441deb 100644
--- a/docs/guides/ingress/http/single-service.md
+++ b/docs/guides/ingress/http/single-service.md
@@ -24,7 +24,7 @@ metadata:
   name: test-ingress
   namespace: default
 spec:
-  backend:
+  defaultBackend:
     service:
       name: test-service
       port:
@@ -45,7 +45,7 @@ metadata:
   name: test-ingress
   namespace: default
 spec:
-  backend:
+  defaultBackend:
     service:
       name: default-service
       port:
diff --git a/docs/guides/ingress/scaling.md b/docs/guides/ingress/scaling.md
index 945db0605..c70d98ce8 100644
--- a/docs/guides/ingress/scaling.md
+++ b/docs/guides/ingress/scaling.md
@@ -34,7 +34,7 @@ metadata:
   annotations:
     ingress.appscode.com/replicas: '2'
 spec:
-  backend:
+  defaultBackend:
     service:
       name: my-app
       port:
diff --git a/docs/guides/ingress/security/tls-auth.md b/docs/guides/ingress/security/tls-auth.md
index f70d2454b..7e0f9895a 100644
--- a/docs/guides/ingress/security/tls-auth.md
+++ b/docs/guides/ingress/security/tls-auth.md
@@ -60,9 +60,7 @@ metadata:
   namespace: default
 spec:
   tls:
-  - ref:
-      kind: Secret
-      name: server
+  - secretName: server
     hosts:
     - auth.example.com
   rules:
diff --git a/docs/guides/ingress/tls/backend-tls.md b/docs/guides/ingress/tls/backend-tls.md
index a93197001..73e2a3f32 100644
--- a/docs/guides/ingress/tls/backend-tls.md
+++ b/docs/guides/ingress/tls/backend-tls.md
@@ -60,7 +60,7 @@ metadata:
   name: test-ingress
   namespace: default
 spec:
-  backend:
+  defaultBackend:
     service:
       name: test-service
       port: