--- a/src/java.base/share/classes/java/lang/Class.java
+++ b/src/java.base/share/classes/java/lang/Class.java
@@ -923,6 +923,12 @@ 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};
+     * distinct classes may share a common name but have different class loaders.
+     * In addition, {@linkplain #isHidden() hidden} classes 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
@@ -4542,8 +4548,7 @@ public final class Class<T> implements java.io.Serializable,
      * ({@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
+     * 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
--- a/src/java.base/share/classes/java/lang/invoke/MethodType.java
+++ b/src/java.base/share/classes/java/lang/invoke/MethodType.java
@@ -1168,7 +1168,8 @@ class MethodType
      * <p>
      * Note that 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 +1224,16 @@ 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}.
+     * @apiNote
+     * This is not a strict inverse of {@link #fromMethodDescriptorString fromMethodDescriptorString}
+     * because the latter requires 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.
+     * In addition, the result string is not a bytecode descriptor if this
+     * method type 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}.
-     * {@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>