Template best practices: declared template indentation practice

Author: consideRatio

content/en/docs/chart_best_practices/templates.md

@@ -49,7 +49,25 @@ as the template names are automatically defined as per this best practice.
 
 ## Formatting Templates
 
-Templates should be indented using _two spaces_ (never tabs).
+Templates should align with associated content.
+
+Correct:
+
+```yaml
+myList:
+  {{- range .Values.elements }}
+  - {{ . }}
+  {{- end }}
+```
+
+Incorrect:
+
+```yaml
+myList:
+{{- range .Values.elements }}
+  - {{ . }}
+{{- end }}
+```
 
 Template directives should have whitespace after the opening braces and before
 the closing braces:
@@ -93,6 +111,32 @@ apiVersion: v1
 
 ## Whitespace in Generated Templates
 
+Generated content should be indented with increments of _two spaces_.
+
+Correct:
+
+```yaml
+apiVersion: batch/v1
+kind: Job
+metadata:
+  name: example
+  labels:
+    first: first
+    second: second
+```
+
+Incorrect:
+
+```yaml
+apiVersion: batch/v1
+kind: Job
+metadata:
+    name: example
+    labels:
+        first: first
+        second: second
+```
+
 It is preferable to keep the amount of whitespace in generated templates to a
 minimum. In particular, numerous blank lines should not appear adjacent to each
 other. But occasional empty lines (particularly between logical sections) is