GH-1567 - Polishing.

Author: odrotbohm

spring-modulith-observability/spring-modulith-observability-api/src/main/java/org/springframework/modulith/observability/ObservedModule.java

@@ -46,7 +46,7 @@ public interface ObservedModule {
 	String getDisplayName();
 
 	/**
-	 * Returns the name of the actually invoked {@link Method}.
+	 * Returns the name of the actually invoked {@link java.lang.reflect.Method}.
 	 *
 	 * @param invocation must not be {@literal null}.
 	 * @return

spring-modulith-observability/spring-modulith-observability-core/src/main/java/org/springframework/modulith/observability/support/ModuleEventCounterFactory.java

@@ -28,9 +28,9 @@
 import org.springframework.util.Assert;
 
 /**
- * A factory to create {@link Builder} instances for {@link Counter}s eventually. Target for dependency injection via
- * the {@link org.springframework.modulith.observability.ModulithEventMetricsCustomizer} interface to allow users to
- * augment the counters with additional information.
+ * A factory to create {@link Builder} instances for {@link io.micrometer.core.instrument.Counter}s eventually. Target
+ * for dependency injection via the {@link org.springframework.modulith.observability.ModulithEventMetricsCustomizer}
+ * interface to allow users to augment the counters with additional information.
  *
  * @author Oliver Drotbohm
  * @author Marcin Grzejszczak

spring-modulith-observability/spring-modulith-observability-core/src/main/java/org/springframework/modulith/observability/support/ModuleEventListener.java

@@ -45,7 +45,7 @@ public class ModuleEventListener implements ApplicationListener<ApplicationEvent
 
 	/**
 	 * Creates a new {@link ModuleEventListener} for the given {@link ApplicationModulesRuntime} and
-	 * {@link ObservationRegistry} and {@link MeterRegistry}.
+	 * {@link MeterRegistry}.
 	 *
 	 * @param runtime must not be {@literal null}.
 	 * @param meterRegistrySupplier must not be {@literal null}.

spring-modulith-observability/spring-modulith-observability-core/src/main/java/org/springframework/modulith/observability/support/ObservedModuleEvent.java

@@ -22,7 +22,7 @@
 import org.springframework.modulith.observability.ModulithMetrics;
 
 /**
- * An observed event associated with the {@link ApplicationModule} it originates from.
+ * An observed event associated with the {@link org.springframework.modulith.core.ApplicationModule} it originates from.
  *
  * @author Oliver Drotbohm
  * @since 2.1

src/docs/antora/modules/ROOT/pages/production-ready.adoc

@@ -195,6 +195,9 @@ In this particular case, triggering the payment changes the state of the order w
 This gets picked up asynchronously by the engine that triggers another state change on the order, works for a couple of seconds and triggers the final state change on the order in turn.
 
 [[observability-spans]]
+=== Observability Spans
+
+[[observability-spans-module-entry]]
 ==== Module Entry Span
 
 .Tag Keys