Use Markdown syntax in API documentation

Author: sormuras

junit-start/src/main/java/module-info.java

@@ -8,23 +8,23 @@
  * https://www.eclipse.org/legal/epl-v20.html
  */
 
-/**
- * Defines the API of the JUnit Start module for writing and running tests.
- * <p>
- * Usage example:
- * <pre>{@code
- * import module org.junit.start;
- *
- *  void main() {
- *    JUnit.run();
- *  }
- *
- *  @Test
- *  void addition() {
- *    Assertions.assertEquals(2, 1 + 1, "Addition error detected!");
- *  }
- * }</pre>
- */
+
+/// Defines the API of the JUnit Start module for writing and running tests.
+///
+/// Usage example:
+/// ```java
+/// import module org.junit.start;
+///
+///  void main() {
+///    JUnit.run();
+///  }
+///
+///  @Test
+///  void addition() {
+///    Assertions.assertEquals(2, 1 + 1, "Addition error detected!");
+///   }
+/// }
+/// ```
 module org.junit.start {
 	requires static transitive org.apiguardian.api;
 	requires static transitive org.jspecify;

junit-start/src/main/java/org/junit/start/JUnit.java

@@ -28,28 +28,23 @@
 import org.junit.platform.launcher.core.LauncherFactory;
 import org.junit.platform.launcher.listeners.SummaryGeneratingListener;
 
-@API(status = EXPERIMENTAL, since = "6.0")
+/// This class provides simple helpers to discover and execute tests.
+@API(status = EXPERIMENTAL, since = "6.1")
 public final class JUnit {
-	/**
-	 * Run all tests defined in the caller class.
-	 */
+	/// Run all tests defined in the caller class.
 	public static void run() {
 		var walker = StackWalker.getInstance(RETAIN_CLASS_REFERENCE);
 		run(selectClass(walker.getCallerClass()));
 	}
 
-	/**
-	 * Run all tests defined in the given test class.
-	 * @param testClass  the class to discover and execute tests in
-	 */
+	/// Run all tests defined in the given test class.
+	/// @param testClass the class to discover and execute tests in
 	public static void run(Class<?> testClass) {
 		run(selectClass(testClass));
 	}
 
-	/**
-	 * Run all tests defined in the given module.
-	 * @param testModule the module to discover and execute tests in
-	 */
+	/// Run all tests defined in the given module.
+	/// @param testModule the module to discover and execute tests in
 	public static void run(Module testModule) {
 		run(selectModule(testModule));
 	}

junit-start/src/main/java/org/junit/start/package-info.java

@@ -1,7 +1,15 @@
-/**
- * Contains JUnit Start API for writing and running tests.
+/*
+ * Copyright 2015-2025 the original author or authors.
+ *
+ * All rights reserved. This program and the accompanying materials are
+ * made available under the terms of the Eclipse Public License v2.0 which
+ * accompanies this distribution and is available at
+ *
+ * https://www.eclipse.org/legal/epl-v20.html
  */
 
+/// Contains JUnit Start API for writing and running tests.
+
 @NullMarked
 package org.junit.start;