Update javadocs for generic types in HttpServerTracer
MODIFY
instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/tracer/HttpServerTracer.java
instrumentation-api/src/main/java/io/opentelemetry/instrumentation/api/tracer/HttpServerTracer.java
@@ -18,6 +18,18 @@ import java.util.concurrent.TimeUnit;
import org.checkerframework.checker.nullness.qual.Nullable;
// TODO In search for a better home package
+
+/**
+ * Base class for implementing Tracers for HTTP servers. It has 3 types that must be specified by
+ * subclasses:
+ *
+ * @param <REQUEST> - The specific type for HTTP requests
+ * @param <RESPONSE> - The specific type for HTTP responses
+ * @param <CONNECTION> - The specific type of HTTP connection, used to get peer address information
+ * and HTTP flavor.
+ * @param <STORAGE> - Implementation specific storage type for attaching/getting the server context.
+ * Use Void if your subclass does not have an implementation specific storage need.
+ */
public abstract class HttpServerTracer<REQUEST, RESPONSE, CONNECTION, STORAGE> extends BaseTracer {
// the class name is part of the attribute name, so that it will be shaded when used in javaagent

Update javadocs for generic types in HttpServerTracer (#1891)