Added more docs

Author: marcingrzejszczak

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoHandlerContext.java

@@ -21,6 +21,12 @@
 import com.mongodb.event.CommandSucceededEvent;
 import io.micrometer.core.instrument.Timer;
 
+/**
+ * A {@link Timer.HandlerContext} that contains Mongo events.
+ *
+ * @author Marcin Grzejszczak
+ * @since 3.0.0
+ */
 public abstract class MongoHandlerContext extends Timer.HandlerContext {
 
 	private final CommandStartedEvent commandStartedEvent;
@@ -53,5 +59,12 @@ public void setCommandFailedEvent(CommandFailedEvent commandFailedEvent) {
 		this.commandFailedEvent = commandFailedEvent;
 	}
 
+	/**
+	 * The contextual name is a name that describes an implementation of this class
+	 * that is more precise within this context. This can be used e.g. as a
+	 * more human-readable span name.
+	 *
+	 * @return contextual name
+	 */
 	public abstract String getContextualName();
 }

spring-data-mongodb/src/main/java/org/springframework/data/mongodb/observability/MongoTracingRecordingHandler.java

@@ -31,6 +31,13 @@
 
 import org.springframework.data.mongodb.core.convert.MappingMongoConverter;
 
+/**
+ * A {@link TracingRecordingHandler} that handles {@link MongoHandlerContext}.
+ * It configures a span specific for Mongo communication.
+ *
+ * @author Marcin Grzejszczak
+ * @since 3.0.0
+ */
 public class MongoTracingRecordingHandler implements TracingRecordingHandler<MongoHandlerContext> {
 
 	private static final Log LOGGER = LogFactory.getLog(MappingMongoConverter.class);
@@ -88,6 +95,11 @@ private void setRemoteIpAndPort(CommandStartedEvent event, Span.Builder spanBuil
 		return context instanceof MongoHandlerContext;
 	}
 
+	/**
+	 * Should remote ip and port be set on the span.
+	 *
+	 * @return {@code true} when the remote ip and port should be set
+	 */
 	public boolean isSetRemoteIpAndPortEnabled() {
 		return this.setRemoteIpAndPortEnabled;
 	}