add docs

Signed-off-by: Gregor Zeitlinger <[email protected]>

Author: zeitlinger

docs/content/exporters/formats.md

@@ -11,16 +11,35 @@ All exporters the following exposition formats:
 
 Moreover, gzip encoding is supported for each of these formats.
 
-Scraping with a Prometheus server
----------------------------------
+## Scraping with a Prometheus server
 
 The Prometheus server sends an `Accept` header to specify which format is requested. By default, the Prometheus server will scrape OpenMetrics text format with gzip encoding. If the Prometheus server is started with `--enable-feature=native-histograms`, it will scrape Prometheus protobuf format instead.
 
-Viewing with a Web Browser
---------------------------
+## Viewing with a Web Browser
 
 If you view the `/metrics` endpoint with your Web browser you will see Prometheus text format. For quick debugging of the other formats, exporters provide a `debug` URL parameter:
 
 * `/metrics?debug=openmetrics`: View OpenMetrics text format.
 * `/metrics?debug=text`: View Prometheus text format.
 * `/metrics?debug=prometheus-protobuf`: View a text representation of the Prometheus protobuf format.
+
+## Exclude protobuf exposition format
+
+You can exclude the protobuf exposition format by including the
+`prometheus-metrics-exposition-textformats` module and excluding the
+`prometheus-metrics-exposition-formats` module in your build file.
+
+For example, in Maven:
+
+```xml
+<dependency>
+    <groupId>io.prometheus</groupId>
+    <artifactId>prometheus-metrics-exporter-httpserver</artifactId>
+    <exclusions>
+        <exclusion>
+            <groupId>io.prometheus</groupId>
+            <artifactId>prometheus-metrics-exposition-formats</artifactId>
+        </exclusion>
+    </exclusions>
+</dependency>
+```

docs/content/getting-started/quickstart.md

@@ -45,6 +45,14 @@ implementation 'io.prometheus:prometheus-metrics-exporter-httpserver:$version'
 
 There are alternative exporters as well, for example if you are using a Servlet container like Tomcat or Undertow you might want to use `prometheus-exporter-servlet-jakarta` rather than a standalone HTTP server.
 
+{{< hint type=note >}}
+
+If you do not use the protobuf exposition format, you can 
+[exclude](../../exporters/formats#exclude-protobuf-exposition-format)
+it from the dependencies. 
+
+{{< /hint >}}
+
 # Dependency management
 
 A Bill of Material

docs/content/internals/model.md

@@ -7,25 +7,23 @@ The illustration below shows the internal architecture of the Prometheus Java cl
 
 ![Internal architecture of the Prometheus Java client library](/client_java/images/model.png)
 
-prometheus-metrics-core
------------------------
+## prometheus-metrics-core
 
 This is the user facing metrics library, implementing the core metric types, like [Counter](/client_java/api/io/prometheus/metrics/core/metrics/Counter.html), [Gauge](/client_java/api/io/prometheus/metrics/core/metrics/Gauge.html) [Histogram](/client_java/api/io/prometheus/metrics/core/metrics/Histogram.html), and so on.
 
 All metric types implement the [Collector](/client_java/api/io/prometheus/metrics/model/registry/Collector.html) interface, i.e. they provide a [collect()](/client_java/api/io/prometheus/metrics/model/registry/Collector.html#collect()) method to produce snapshots.
 
-prometheus-metrics-model
-------------------------
+## prometheus-metrics-model
 
 The model is an internal library, implementing read-only immutable snapshots. These snapshots are returned by the [Collector.collect()](/client_java/api/io/prometheus/metrics/model/registry/Collector.html#collect()) method.
 
 There is no need for users to use `prometheus-metrics-model` directly. Users should use the API provided by `prometheus-metrics-core`, which includes the core metrics as well as callback metrics.
 
 However, maintainers of 3rd party metrics libraries might want to use `prometheus-metrics-model` if they want to add Prometheus exposition formats to their metrics library.
 
-exporters and exposition formats
---------------------------------
+## Exporters and exposition formats
 
 The `prometheus-metrics-exposition-formats` module converts snapshots to Prometheus exposition formats, like text format, OpenMetrics text format, or Prometheus protobuf format.
 
 The exporters like `prometheus-metrics-exporter-httpserver` or `prometheus-metrics-exporter-servlet-jakarta` use this to convert snapshots into the right format depending on the `Accept` header in the scrape request.
+