Polish Micrometer Observation documentation

References #379

Author: acogoluegnes

src/docs/asciidoc/appendixes.adoc

@@ -7,14 +7,16 @@ ifndef::build-directory[:build-directory: ../../../target]
 It is possible to use https://micrometer.io/docs/observation[Micrometer Observation] to instrument publishing and consuming in the stream Java client.
 Micrometer Observation provides https://spring.io/blog/2022/10/12/observability-with-spring-boot-3[metrics, tracing, and log correlation with one single API].
 
-The following snippet shows how to create and set up the Micrometer `ObservationCollector` from an existing `ObservationRegistry`:
+The stream Java client provides an `ObservationCollector` abstraction and an implementation for Micrometer Observation.
+The following snippet shows how to create and set up the Micrometer `ObservationCollector` implementation with an existing `ObservationRegistry`:
 
 .Configuring Micrometer Observation
 [source,java,indent=0]
 --------
 include::{test-examples}/EnvironmentUsage.java[tag=micrometer-observation]
 --------
-<1> Create the Micrometer `ObservationCollector`
+<1> Configure Micrometer `ObservationCollector` with builder
+<2> Set Micrometer `ObservationRegistry`
 
 The next sections document the conventions, spans, and metrics made available by the instrumentation.
 They are automatically generated from the source code with the https://github.com/micrometer-metrics/micrometer-docs-generator[Micrometer documentation generator].

src/test/java/com/rabbitmq/stream/docs/EnvironmentUsage.java

@@ -154,7 +154,7 @@ void micrometerObservation() {
  // tag::micrometer-observation[]
  Environment environment = Environment.builder()
  .observationCollector(new MicrometerObservationCollectorBuilder() // <1>
- .registry(observationRegistry).build()) // <1>
+ .registry(observationRegistry).build()) // <2>
  .build();
  // end::micrometer-observation[]
  }