Add missing @⁠since tag and polish/format Javadoc

Author: sbrannen

junit-platform-engine/src/main/java/org/junit/platform/engine/TestDescriptor.java

@@ -177,16 +177,16 @@ default Set<? extends TestDescriptor> getDescendants() {
 	void removeFromHierarchy();
 
 	/**
-	 * Order the children from this descriptor.
+	 * Order the children of this descriptor.
 	 *
 	 * <p>The {@code orderer} is provided a modifiable list of child test
-	 * descriptors in this test descriptor; never {@code null}. The
+	 * descriptors of this test descriptor; never {@code null}. The
 	 * {@code orderer} must return a list containing the same descriptors in any
 	 * order; potentially the same list, but never {@code null}. If descriptors
-	 * were added or removed, an exception is thrown.
+	 * are added or removed, an exception is thrown.
 	 *
-	 * @param orderer a unary operator to order the children of this test
-	 * descriptor.
+	 * @param orderer a unary operator to order the children of this test descriptor
+	 * @since 1.12
 	 */
 	@API(since = "1.12", status = EXPERIMENTAL)
 	default void orderChildren(UnaryOperator<List<TestDescriptor>> orderer) {

junit-vintage-engine/src/main/java/org/junit/vintage/engine/Constants.java

@@ -47,21 +47,23 @@ public final class Constants {
 	public static final String PARALLEL_POOL_SIZE = "junit.vintage.execution.parallel.pool-size";
 
 	/**
-	 * Indicates whether parallel execution is enabled for test classes in the JUnit Vintage engine.
+	 * Indicates whether parallel execution is enabled for test classes in the
+	 * JUnit Vintage engine.
 	 *
-	 * <p>Set this property to {@code true} to enable parallel execution of test classes.
-	 * Defaults to {@code false}.
+	 * <p>Set this property to {@code true} to enable parallel execution of test
+	 * classes. Defaults to {@code false}.
 	 *
 	 * @since 5.12
 	 */
 	@API(status = EXPERIMENTAL, since = "5.12")
 	public static final String PARALLEL_CLASS_EXECUTION = "junit.vintage.execution.parallel.classes";
 
 	/**
-	 * Indicates whether parallel execution is enabled for test methods in the JUnit Vintage engine.
+	 * Indicates whether parallel execution is enabled for test methods in the
+	 * JUnit Vintage engine.
 	 *
-	 * <p>Set this property to {@code true} to enable parallel execution of test methods.
-	 * Defaults to {@code false}.
+	 * <p>Set this property to {@code true} to enable parallel execution of test
+	 * methods. Defaults to {@code false}.
 	 *
 	 * @since 5.12
 	 */

junit-vintage-engine/src/main/java/org/junit/vintage/engine/execution/VintageExecutor.java

@@ -186,4 +186,5 @@ private void shutdownExecutorService(ExecutorService executorService) {
 			Thread.currentThread().interrupt();
 		}
 	}
+
 }