diff --git a/documentation/examples/prometheus-puppetdb.yml b/documentation/examples/prometheus-puppetdb.yml
index f7f4313e72..5b10d39fc7 100644
--- a/documentation/examples/prometheus-puppetdb.yml
+++ b/documentation/examples/prometheus-puppetdb.yml
@@ -14,11 +14,10 @@ scrape_configs:
 
   - job_name: 'puppetdb-scrape-jobs'
     puppetdb_sd_configs:
-    # This example uses the Prometheus::Scrape_job
-    # exported resources.
-    # https://github.com/camptocamp/prometheus-puppetdb-sd
-    # This examples is compatible with Prometheus-puppetdb-sd,
-    # if the exported Prometheus::Scrape_job only have at most one target.
+    # This example uses Prometheus::Scrape_job exported resources.
+    # It is compatible with the prometheus-puppetdb-sd
+    # (https://github.com/camptocamp/prometheus-puppetdb-sd) if the
+    # exported resources have exactly one target.
       - url: https://puppetdb.example.com
         query: 'resources { type = "Prometheus::Scrape_job" and exported = true }'
         include_parameters: true