From a4e40c949e3696eced5a994209b82000eecdebb8 Mon Sep 17 00:00:00 2001
From: Yngve Aasheim <yngveaasheim@users.noreply.github.com>
Date: Tue, 17 Oct 2023 13:17:51 +0200
Subject: Add a short description to metric set reference documentation

---
 .../main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java   | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

(limited to 'metrics/src')

diff --git a/metrics/src/main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java b/metrics/src/main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java
index b046d55c089..a15f2916091 100644
--- a/metrics/src/main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java
+++ b/metrics/src/main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java
@@ -45,8 +45,14 @@ public class MetricSetDocumentation {
         referenceBuilder.append(String.format("""
                 ---
                 # Copyright Vespa.ai. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
+                # Note: This file is generated by
+                # https://github.com/vespa-engine/vespa/blob/master/metrics/src/main/java/ai/vespa/metrics/docs/MetricSetDocumentation.java
                 title: "%s Metric Set"
-                ---""", name));
+                ---
+                <p>
+                    This document provides reference documentation for the %s metric set, including suffixes present per metric.
+                    If the suffix column contains "N/A" then the base name of the corresponding metric is used with no suffix.
+                </p>""", name, name));
         metricsByType.keySet()
                 .stream()
                 .sorted()
-- 
cgit v1.2.3