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[]
     }