--- a/src/java.base/share/classes/java/lang/Class.java
+++ b/src/java.base/share/classes/java/lang/Class.java
@@ -923,6 +923,14 @@ public final class Class<T> implements java.io.Serializable,
      *     returns "[[[[[[[I"
      * </pre></blockquote>
      *
+     * @apiNote
+     * This is not a strict inverse of {@link #forName(String) forName(String)}.
+     * Distinct classes which share a common name but have different class
+     * loaders will have the identical name. {@linkplain #isPrimitive()
+     * Primitive types}, {@linkplain #isHidden() hidden} classes, and array
+     * classes whose element type is a hidden class or interface cannot be
+     * discovered by {@code forName}.
+     *
      * @return  the name of the class, interface, or other entity
      *          represented by this {@code Class} object.
      * @jls 13.1 The Form of a Binary
@@ -4541,11 +4549,6 @@ public final class Class<T> implements java.io.Serializable,
      * is a one-letter code corresponding to a primitive type or {@code void}
      * ({@code "B", "C", "D", "F", "I", "J", "S", "Z", "V"}) (JVMS {@jvms 4.3.2}).
      *
-     * @apiNote
-     * This is not a strict inverse of {@link #forName};
-     * distinct classes which share a common name but have different class loaders
-     * will have identical descriptor strings.
-     *
      * @return the descriptor string for this {@code Class} object
      * @jvms 4.3.2 Field Descriptors
      * @since 12
--- a/src/java.base/share/classes/java/lang/invoke/MethodType.java
+++ b/src/java.base/share/classes/java/lang/invoke/MethodType.java
@@ -1165,10 +1165,12 @@ class MethodType
      * Convenience method for {@link #methodType(java.lang.Class, java.lang.Class[]) methodType}.
      * Any class or interface name embedded in the descriptor string will be
      * resolved by the given loader (or if it is null, on the system class loader).
-     * <p>
-     * Note that it is possible to encounter method types which cannot be
+     *
+     * @apiNote
+     * It is possible to encounter method types which cannot be
      * constructed by this method, because their component types are
-     * not all reachable from a common class loader.
+     * not all reachable from a common class loader, or some component types
+     * cannot be {@linkplain ##descriptor described nominally}.
      * <p>
      * This method is included for the benefit of applications that must
      * generate bytecodes that process method handles and {@code invokedynamic}.
@@ -1223,15 +1225,15 @@ class MethodType
      * Returns a descriptor string for the method type.  This method
      * is equivalent to calling {@link #descriptorString() MethodType::descriptorString}.
      *
-     * <p>
-     * Note that this is not a strict inverse of {@link #fromMethodDescriptorString fromMethodDescriptorString}.
-     * Two distinct classes which share a common name but have different class loaders
-     * will appear identical when viewed within descriptor strings.
+     * @apiNote
+     * This is not a strict inverse of {@link #fromMethodDescriptorString
+     * fromMethodDescriptorString} which requires a method type descriptor
+     * (JVMS {@jvms 4.3.3}) and a suitable class loader argument. Two distinct
+     * classes which share a common name but have different class loaders will
+     * appear identical when viewed within descriptor strings.
      * <p>
      * This method is included for the benefit of applications that must
      * generate bytecodes that process method handles and {@code invokedynamic}.
-     * {@link #fromMethodDescriptorString(java.lang.String, java.lang.ClassLoader) fromMethodDescriptorString},
-     * because the latter requires a suitable class loader argument.
      * @return the descriptor string for this method type
      * @jvms 4.3.3 Method Descriptors
      * @see <a href="#descriptor">Nominal Descriptor for {@code MethodType}</a>