HHH-15894 - Clean-up EntityMappingType for API

hibernate-core/src/main/java/org/hibernate/metamodel/mapping/Discriminatable.java

@@ -14,10 +14,6 @@ import org.hibernate.sql.ast.tree.predicate.Predicate;
 
 /**
  * Things that have a discriminator associated with it.
- *
- * @apiNote Plural-attributes are considered discriminatable, which only
- * has an effect for to-many collections and applies the discriminator from
- * the associated entity
  */
 public interface Discriminatable {
 	/**

hibernate-core/src/main/java/org/hibernate/metamodel/mapping/ManagedMappingType.java

@@ -14,9 +14,7 @@ import org.hibernate.sql.results.graph.FetchableContainer;
 import org.hibernate.type.descriptor.java.JavaType;
 
 /**
- * Mapping-model corollary to JPA's {@link jakarta.persistence.metamodel.ManagedType}
- *
- * @see jakarta.persistence.metamodel.ManagedType
+ * Mapping-model corollary to {@link jakarta.persistence.metamodel.ManagedType}
  *
  * @author Steve Ebersole
  */

hibernate-core/src/main/java/org/hibernate/metamodel/mapping/Restrictable.java

@@ -17,7 +17,9 @@ import org.hibernate.sql.ast.tree.predicate.Predicate;
 
 /**
  * Things that can have {@link org.hibernate.annotations.Where},
- * and/or {@link org.hibernate.annotations.Filter} applied to them
+ * and/or {@link org.hibernate.annotations.Filter} applied to them.
+ * This is effectively {@linkplain EntityMappingType entities} and
+ * {@linkplain PluralAttributeMapping plural attributes}.
  */
 public interface Restrictable extends FilterRestrictable, WhereRestrictable {
 	/**

hibernate-core/src/main/java/org/hibernate/sql/results/graph/Fetchable.java

@@ -16,7 +16,8 @@ import org.hibernate.metamodel.model.domain.NavigableRole;
 import org.hibernate.spi.NavigablePath;
 
 /**
- * Parts of the domain model that can be fetched
+ * Parts of the domain model that can be fetched.  In other words,
+ * a {@link ModelPart} which can produce {@link Fetch} references.
  *
  * @author Steve Ebersole
  */