fix: use block markdownlint suppression for MD036, fix tracking for github: backend

Signed-off-by: Gregor Zeitlinger <gregor.zeitlinger@grafana.com>

Author: zeitlinger

.github/renovate-tracked-deps.json

@@ -167,6 +167,7 @@
       "actionlint",
       "cargo:https://github.com/grafana/flint",
       "editorconfig-checker",
+      "github:google/google-java-format",
       "go:github.com/gohugoio/hugo",
       "go:github.com/grafana/oats",
       "java",
@@ -179,8 +180,7 @@
       "pipx:ruff",
       "protoc",
       "shellcheck",
-      "shfmt",
-      "ubi:google/google-java-format"
+      "shfmt"
     ]
   },
   "mvnw": {

docs/content/_index.md

@@ -13,14 +13,14 @@ The main new features of the 1.0.0 release are:
 - **Runtime configuration:** Configure metrics, exporters, and more at runtime using a properties
   file or system properties.
 
-<!-- markdownlint-disable-next-line MD036 -->
+<!-- markdownlint-disable MD036 -->
+
 **Documentation and Examples**
 
 In addition to this documentation page we created an
 [examples/](https://github.com/prometheus/client_java/tree/main/examples) directory with end-to-end
 scenarios (Docker compose) illustrating new features.
 
-<!-- markdownlint-disable-next-line MD036 -->
 **Performance Benchmarks**
 
 Initial performance benchmarks are looking great: All core metric types (including native
@@ -29,7 +29,6 @@ that utilizes all processor cores in parallel the metrics library will not intro
 synchronization. See Javadoc comments in
 [benchmarks/](https://github.com/prometheus/client_java/tree/main/benchmarks) for benchmark results.
 
-<!-- markdownlint-disable-next-line MD036 -->
 **More Info**
 
 The Grafana Labs Blog has a post
@@ -40,9 +39,10 @@ There will also be a presentation at the [PromCon](https://promcon.io) conferenc
 Tune in to the live stream on [https://promcon.io](https://promcon.io)
 or watch the recording on YouTube.
 
-<!-- markdownlint-disable-next-line MD036 -->
 **For users of the 0.16.0 version and older**
 
+<!-- markdownlint-enable MD036 -->
+
 Updating to the 1.0.0 version is a breaking change. However, there's a
 `prometheus-metrics-simpleclient-bridge` module available that allows you to use your existing
 simpleclient 0.16.0 metrics with the new 1.0.0 `PrometheusRegistry`.

docs/content/config/config.md

@@ -92,9 +92,12 @@ When the same property is defined in multiple sources, the following precedence
 
 <!-- editorconfig-checker-enable -->
 
-<!-- markdownlint-disable-next-line MD036 -->
+<!-- markdownlint-disable MD036 -->
+
 **Notes**
 
+<!-- markdownlint-enable MD036 -->
+
 (1) _withExemplars()_ and _withoutExemplars()_ are available for all metric types,
 not just for counters<br>
 (2) Boolean value. Format: `property=true` or `property=false`.<br>

docs/content/getting-started/metric-types.md

@@ -127,7 +127,8 @@ The default bucket boundaries are designed for measuring request durations in se
 use cases, you may want to define custom bucket boundaries. The histogram builder provides three
 methods for this:
 
-<!-- markdownlint-disable-next-line MD036 -->
+<!-- markdownlint-disable MD036 -->
+
 **1. Arbitrary Custom Boundaries**
 
 Use `classicUpperBounds(...)` to specify arbitrary bucket boundaries:
@@ -140,7 +141,6 @@ Histogram responseSize = Histogram.builder()
     .register();
 ```
 
-<!-- markdownlint-disable-next-line MD036 -->
 **2. Linear Boundaries**
 
 Use `classicLinearUpperBounds(start, width, count)` for equal-width buckets:
@@ -153,9 +153,10 @@ Histogram queueSize = Histogram.builder()
     .register();
 ```
 
-<!-- markdownlint-disable-next-line MD036 -->
 **3. Exponential Boundaries**
 
+<!-- markdownlint-enable MD036 -->
+
 Use `classicExponentialUpperBounds(start, factor, count)` for exponential growth:
 
 ```java

integration-tests/it-exporter/it-exporter-test/src/test/java/io/prometheus/metrics/it/exporter/test/DuplicateMetricsIT.java

@@ -25,23 +25,23 @@ void testDuplicateMetricsInPrometheusTextFormat() throws IOException {
 
     String expected =
         """
-    # HELP active_connections Active connections
-    # TYPE active_connections gauge
-    active_connections{pool="primary",type="read"} 30.0
-    active_connections{pool="replica",type="write"} 10.0
-    active_connections{protocol="http",region="us-east"} 42.0
-    active_connections{protocol="http",region="us-west"} 38.0
-    active_connections{protocol="https",region="eu-west"} 55.0
-    # HELP http_requests_total Total HTTP requests by status
-    # TYPE http_requests_total counter
-    http_requests_total{endpoint="/api",status="error"} 5.0
-    http_requests_total{endpoint="/health",status="error"} 2.0
-    http_requests_total{method="GET",status="success"} 150.0
-    http_requests_total{method="POST",status="success"} 45.0
-    # HELP unique_metric_bytes_total A unique metric for reference
-    # TYPE unique_metric_bytes_total counter
-    unique_metric_bytes_total 1024.0
-    """;
+        # HELP active_connections Active connections
+        # TYPE active_connections gauge
+        active_connections{pool="primary",type="read"} 30.0
+        active_connections{pool="replica",type="write"} 10.0
+        active_connections{protocol="http",region="us-east"} 42.0
+        active_connections{protocol="http",region="us-west"} 38.0
+        active_connections{protocol="https",region="eu-west"} 55.0
+        # HELP http_requests_total Total HTTP requests by status
+        # TYPE http_requests_total counter
+        http_requests_total{endpoint="/api",status="error"} 5.0
+        http_requests_total{endpoint="/health",status="error"} 2.0
+        http_requests_total{method="GET",status="success"} 150.0
+        http_requests_total{method="POST",status="success"} 45.0
+        # HELP unique_metric_bytes_total A unique metric for reference
+        # TYPE unique_metric_bytes_total counter
+        unique_metric_bytes_total 1024.0
+        """;
 
     assertThat(response.stringBody()).isEqualTo(expected);
   }
@@ -59,25 +59,25 @@ void testDuplicateMetricsInOpenMetricsTextFormat() throws IOException {
     // OpenMetrics format should have UNIT for unique_metric_bytes (base name without _total)
     String expected =
         """
-    # TYPE active_connections gauge
-    # HELP active_connections Active connections
-    active_connections{pool="primary",type="read"} 30.0
-    active_connections{pool="replica",type="write"} 10.0
-    active_connections{protocol="http",region="us-east"} 42.0
-    active_connections{protocol="http",region="us-west"} 38.0
-    active_connections{protocol="https",region="eu-west"} 55.0
-    # TYPE http_requests counter
-    # HELP http_requests Total HTTP requests by status
-    http_requests_total{endpoint="/api",status="error"} 5.0
-    http_requests_total{endpoint="/health",status="error"} 2.0
-    http_requests_total{method="GET",status="success"} 150.0
-    http_requests_total{method="POST",status="success"} 45.0
-    # TYPE unique_metric_bytes counter
-    # UNIT unique_metric_bytes bytes
-    # HELP unique_metric_bytes A unique metric for reference
-    unique_metric_bytes_total 1024.0
-    # EOF
-    """;
+        # TYPE active_connections gauge
+        # HELP active_connections Active connections
+        active_connections{pool="primary",type="read"} 30.0
+        active_connections{pool="replica",type="write"} 10.0
+        active_connections{protocol="http",region="us-east"} 42.0
+        active_connections{protocol="http",region="us-west"} 38.0
+        active_connections{protocol="https",region="eu-west"} 55.0
+        # TYPE http_requests counter
+        # HELP http_requests Total HTTP requests by status
+        http_requests_total{endpoint="/api",status="error"} 5.0
+        http_requests_total{endpoint="/health",status="error"} 2.0
+        http_requests_total{method="GET",status="success"} 150.0
+        http_requests_total{method="POST",status="success"} 45.0
+        # TYPE unique_metric_bytes counter
+        # UNIT unique_metric_bytes bytes
+        # HELP unique_metric_bytes A unique metric for reference
+        unique_metric_bytes_total 1024.0
+        # EOF
+        """;
 
     assertThat(response.stringBody()).isEqualTo(expected);
   }

prometheus-metrics-core/src/test/java/io/prometheus/metrics/core/metrics/CounterTest.java

@@ -122,7 +122,8 @@ void testTotalStrippedFromName(String name) {
         new PrometheusProtobufWriterImpl().convert(counter.collect(), EscapingScheme.ALLOW_UTF8);
     assertThat(ProtobufUtil.shortDebugString(protobufData))
         .matches(
-            "^name: \"my_counter_seconds_total\" type: COUNTER metric \\{ counter \\{ value: 0.0 created_timestamp \\{ seconds: \\d+ nanos: \\d+ } } }$");
+            "^name: \"my_counter_seconds_total\" type: COUNTER metric \\{ counter \\{ value: 0.0"
+                + " created_timestamp \\{ seconds: \\d+ nanos: \\d+ } } }$");
   }
 
   @Test