Issues 938-document inheritance support

junit-jupiter-api/src/main/java/org/junit/jupiter/api/AssertionFailureBuilder.java

@@ -30,6 +30,11 @@
  * <p>Using this builder ensures consistency in how failure message are formatted
  * within JUnit Jupiter and for custom user-defined assertions.
  *
+ * <h2>Extensibility</h2>
+ *
+ * <p>Although it is technically possible to extend this class, extension is
+ * strongly discouraged.
+ *
  * @since 5.9
  * @see AssertionFailedError
  */

junit-jupiter-params/src/main/java/org/junit/jupiter/params/aggregator/ArgumentAccessException.java

@@ -22,6 +22,10 @@
  * {@link ArgumentsAccessor} if an error occurs while accessing
  * or converting an argument.
  *
+ * <h2>Extensibility</h2>
+ *
+ * <p>This class is designed for extension.
+ *
  * @since 5.2
  * @see ArgumentsAccessor
  */

junit-jupiter-params/src/main/java/org/junit/jupiter/params/aggregator/ArgumentsAggregationException.java

@@ -22,6 +22,10 @@
  * {@link ArgumentsAggregator} when an error occurs while aggregating
  * arguments.
  *
+ * <h2>Extensibility</h2>
+ *
+ * <p>This class is designed for extension.
+ *
  * @since 5.2
  * @see ArgumentsAggregator
  */

junit-jupiter-params/src/main/java/org/junit/jupiter/params/provider/AnnotationBasedArgumentsProvider.java

@@ -30,6 +30,10 @@
  * {@link ArgumentsProvider} implementations that also need to consume an
  * annotation in order to provide the arguments.
  *
+ * <h2>Extensibility</h2>
+ *
+ * <p>This class is designed for extension.
+ *
  * @since 5.10
  * @see org.junit.jupiter.params.ParameterizedClass
  * @see org.junit.jupiter.params.ParameterizedTest