Improve Javadoc of TestResourceScope

test-framework/common/src/main/java/io/quarkus/test/common/TestResourceScope.java

@@ -11,16 +11,26 @@ public enum TestResourceScope {
 
     /**
      * Means that Quarkus will run the test in complete isolation, i.e. it will restart every time it finds such a resource.
+     * <p>
+     * Restarting Quarkus for this test means that the test resources will be restarted.
+     * This includes the global test resources and the Dev Services.
+     * <p>
+     * Use with caution as it might slow down your test suite significantly.
      */
     RESTRICTED_TO_CLASS,
 
     /**
      * Means that Quarkus will not restart when running consecutive tests that use the same set of resources.
+     * <p>
+     * Note that when a restart is needed, all the resources will be restarted.
+     * This includes the global test resources and the Dev Services.
+     * <p>
+     * Quarkus groups the tests by test resources to reduce the number of restarts.
      */
     MATCHING_RESOURCES,
 
     /**
-     * Means the resource applies to all tests in the testsuite
+     * Means the resource applies to all tests in the test suite.
      */
     GLOBAL
 }