Improve JavaDoc (though subjective ...)

Author: JooHyukKim

src/main/java/com/fasterxml/jackson/databind/jsontype/TypeResolverBuilder.java

@@ -156,10 +156,8 @@ public TypeDeserializer buildTypeDeserializer(DeserializationConfig config,
 
     /**
      * Method for specifying whether strict type ID handling should be used for this type or not.
-     * This is per-type override of {@link com.fasterxml.jackson.databind.MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}.
-     * Sets {@link Boolean} value provided by {@link OptBoolean#asBoolean()} of configured {@link JsonTypeInfo#requireTypeIdForSubtypes}.
-     * <p>
-     * WARNING: This method will be abstract in Jackson 3.0.
+     * Parameter {@code Boolean requireTypeId} is provided by {@link JsonTypeInfo#requireTypeIdForSubtypes()}.
+     * Configuration using this method will override {@link com.fasterxml.jackson.databind.MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}.
      *
      * @since 2.16
      */

src/main/java/com/fasterxml/jackson/databind/jsontype/impl/StdTypeResolverBuilder.java

@@ -420,7 +420,8 @@ protected boolean allowPrimitiveTypes(MapperConfig<?> config,
     /**
      * Determines whether strict type ID handling should be used for this type or not.
      * This will be enabld as configured by {@link JsonTypeInfo#requireTypeIdForSubtypes()}
-     * unless its value is {@code OptBoolean.DEFAULT}. Otherwise,
+     * unless its value is {@link com.fasterxml.jackson.annotation.OptBoolean#DEFAULT}. 
+     * In case the value of {@link JsonTypeInfo#requireTypeIdForSubtypes()} is {@code OptBoolean.DEFAULT},
      * this will be enabled when either the type has type resolver annotations or if
      * {@link com.fasterxml.jackson.databind.MapperFeature#REQUIRE_TYPE_ID_FOR_SUBTYPES}
      * is enabled.
@@ -434,7 +435,7 @@ protected boolean allowPrimitiveTypes(MapperConfig<?> config,
      * @since 2.15
      */
     protected boolean _strictTypeIdHandling(DeserializationConfig config, JavaType baseType) {
-        // [databind#3877]: since 2.16, allow configuration of per-type strict type handling
+        // [databind#3877]: per-type strict type handling, since 2.16
         if (_requireTypeIdForSubtypes != null && baseType.isConcrete()) {
             return _requireTypeIdForSubtypes;
         }