Improve wording and formatting in Javadoc

Author: sbrannen

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

@@ -46,7 +46,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited by subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.13
  * @see TestTemplate @TestTemplate

junit-jupiter-params/src/main/java/org/junit/jupiter/params/ParameterizedClass.java

@@ -124,7 +124,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited by subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.13
  * @see Parameter

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

@@ -33,7 +33,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsProvider

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

@@ -23,15 +23,15 @@
 
 /**
  * {@code @ArgumentsSources} is a simple container for one or more
- * {@link ArgumentsSource} annotations.
+ * {@link ArgumentsSource @ArgumentsSource} annotations.
  *
  * <p>Note, however, that use of the {@code @ArgumentsSources} container is completely
  * optional since {@code @ArgumentsSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsSource

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

@@ -70,7 +70,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see CsvSource

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

@@ -23,15 +23,15 @@
 
 /**
  * {@code @CsvFileSources} is a simple container for one or more
- * {@link CsvFileSource} annotations.
+ * {@link CsvFileSource @CsvFileSource} annotations.
  *
  * <p>Note, however, that use of the {@code @CsvFileSources} container is completely
  * optional since {@code @CsvFileSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see CsvFileSource

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

@@ -75,7 +75,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see CsvFileSource

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

@@ -23,15 +23,15 @@
 
 /**
  * {@code @CsvSources} is a simple container for one or more
- * {@link CsvSource} annotations.
+ * {@link CsvSource @CsvSource} annotations.
  *
  * <p>Note, however, that use of the {@code @CsvSources} container is completely
  * optional since {@code @CsvSource} is a {@linkplain java.lang.annotation.Repeatable
  * repeatable} annotation.
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.11
  * @see CsvSource

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

@@ -47,7 +47,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.4
  * @see org.junit.jupiter.params.provider.ArgumentsSource

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

@@ -46,7 +46,7 @@
  *
  * <h2>Inheritance</h2>
  *
- * <p>This annotation is inherited to subclasses.
+ * <p>This annotation is {@linkplain Inherited inherited} within class hierarchies.
  *
  * @since 5.0
  * @see org.junit.jupiter.params.provider.ArgumentsSource