diff --git a/docs/configuration/template_examples.md b/docs/configuration/template_examples.md
index 5737c4328..2f35a0fe5 100644
--- a/docs/configuration/template_examples.md
+++ b/docs/configuration/template_examples.md
@@ -5,11 +5,11 @@ sort_rank: 4
 
 # Template examples
 
-Prometheus supports templating in the summary and description fields of
-alerts, as well as in served console pages. Templates have the ability to run
-queries against the local database, iterate over data, use conditionals, format
-data, etc. The Prometheus templating language is based on the
-[Go templating](http://golang.org/pkg/text/template/) system.
+Prometheus supports templating in the annotations and labels of alerts,
+as well as in served console pages. Templates have the ability to run
+queries against the local database, iterate over data, use conditionals,
+format data, etc. The Prometheus templating language is based on the [Go
+templating](http://golang.org/pkg/text/template/) system.
 
 ## Simple alert field templates
 
@@ -19,7 +19,6 @@ expr: up == 0
 for: 5m
 labels:
   - severity: page
-  
 annotations:
   - summary: "Instance {{$labels.instance}} down"
   - description: "{{$labels.instance}} of job {{$labels.job}} has been down for more than 5 minutes."
diff --git a/docs/configuration/template_reference.md b/docs/configuration/template_reference.md
index dabea627f..fada2ca41 100644
--- a/docs/configuration/template_reference.md
+++ b/docs/configuration/template_reference.md
@@ -5,11 +5,11 @@ sort_rank: 5
 
 # Template reference
 
-Prometheus supports templating in the summary and description fields of
-alerts, as well as in served console pages. Templates have the ability to run
-queries against the local database, iterate over data, use conditionals, format
-data, etc. The Prometheus templating language is based on the
-[Go templating](http://golang.org/pkg/text/template/) system.
+Prometheus supports templating in the annotations and labels of alerts,
+as well as in served console pages. Templates have the ability to run
+queries against the local database, iterate over data, use conditionals,
+format data, etc. The Prometheus templating language is based on the [Go
+templating](http://golang.org/pkg/text/template/) system.
 
 ## Data Structures