Merge pull request #38496 from zakkak/2024-01-31-register-for-reflect…

…ion-doc

Reduce ambiguity around RegisterForReflection's defaults

core/runtime/src/main/java/io/quarkus/runtime/annotations/RegisterForReflection.java

@@ -6,7 +6,10 @@
 import java.lang.annotation.Target;
 
 /**
- * Annotation that can be used to force a class to be registered for reflection in native image mode
+ * Annotation that can be used to force a class to be registered for reflection in native image mode.
+ * Note that by default nested classes and interfaces are not registered, unless {@link #ignoreNested()} is set to false.
+ * Similarly, by default only the class itself is registered, not the full class hierarchy. This can be changed by setting
+ * {@link #registerFullHierarchy()} to true.
  */
 @Retention(RetentionPolicy.RUNTIME)
 @Target(ElementType.TYPE)