diff --git a/solr/solr-ref-guide/src/metrics-reporting.adoc b/solr/solr-ref-guide/src/metrics-reporting.adoc
index 0688255de6a..35164754b29 100644
--- a/solr/solr-ref-guide/src/metrics-reporting.adoc
+++ b/solr/solr-ref-guide/src/metrics-reporting.adoc
@@ -549,7 +549,9 @@ These metrics are available only on a per-core basis. Metrics can be aggregated
 
 These metrics are collected in respective registries for each core (e.g., `solr.core.collection1....`), under the `INDEX` category.
 
-Basic metrics are always collected - collection of additional metrics can be turned on using boolean parameters in the `/config/indexConfig/metrics` section of `solrconfig.xml`:
+Metrics collection is controlled by boolean parameters in the `<metrics>` section of `solrconfig.xml`:
+
+Basic metrics:
 
 [source,xml]
 ----
@@ -557,7 +559,24 @@ Basic metrics are always collected - collection of additional metrics can be tur
   ...
   <indexConfig>
     <metrics>
-      <majorMergeDocs>524288</majorMergeDocs>
+      <long name="majorMergeDocs">524288</long>
+      <bool name="merge">true</bool>
+    </metrics>
+    ...
+  </indexConfig>
+...
+</config>
+----
+
+Detailed metrics:
+
+[source,xml]
+----
+<config>
+  ...
+  <indexConfig>
+    <metrics>
+      <long name="majorMergeDocs">524288</long>
       <bool name="mergeDetails">true</bool>
     </metrics>
     ...