slightly improve some javadoc

because I really am this anal

Author: gavinking

hibernate-reactive-core/src/main/java/org/hibernate/reactive/context/Context.java

@@ -44,8 +44,12 @@ public interface Context extends Executor, Service {
     @Override
     void execute(Runnable runnable);
 
-    interface Key<T> {
-
-    }
-
+    /**
+     * An object that identifies something we store in the Vert.x
+     * local context, usually a {@code Session} or
+     * {@code StatelessSession}, but in principle anything at all.
+     *
+     * @param <T> the type of thing we're storing in the context
+     */
+    interface Key<T> {}
 }

hibernate-reactive-core/src/main/java/org/hibernate/reactive/context/impl/BaseKey.java

@@ -11,8 +11,9 @@
 
 /**
  * Implementation of {@link Context.Key} suitable for storing
- * Session, StatelessSession or other type instances in the
- * Vert.x context.
+ * instances of {@code Session} or {@code StatelessSession},
+ * or really anything at all, in the Vert.x context.
+ *
  * @param <T> the type of object being stored in the Context.
  */
 public final class BaseKey<T> implements Context.Key<T> {

hibernate-reactive-core/src/main/java/org/hibernate/reactive/context/impl/MultitenantKey.java

@@ -10,10 +10,14 @@
 import org.hibernate.reactive.context.Context;
 
 /**
- * Implementation of {@link Context.Key} suitable for the
- * use case with multi-tenancy.
- * This wraps the {@link BaseKey} of the same type, allowing
- * instance reuse for efficiency.
+ * Implementation of {@link Context.Key} suitable for use with
+ * multi-tenancy. In a multi-tenant environment, anything we
+ * store in the Vert.x context is keyed not only by its type,
+ * but also by the tenant id.
+ * <p>
+ * An instance of this class wraps a {@link BaseKey} of the same
+ * type, allowing instance reuse for efficiency.
+ *
  * @param <T> the type of object being stored in the Context.
  */
 public final class MultitenantKey<T> implements Context.Key<T> {