Update docs

Author: oowekyala

docs/_plugins/jdoc_namespace_tag.rb

@@ -102,7 +102,7 @@ def self.parse_fqcn(fqcn, var_ctx, allow_sym = true)
   RESERVED_NSPACES = ['apex', 'core', 'cpp', 'cs', 'dart', 'dist', 'doc', 'fortran', 'go', 'groovy', 'java',
     'javascript', 'jsp',
     'kotlin', 'lua', 'matlab', 'objectivec', 'perl', 'php', 'plsql', 'python', 'ruby', 'scala', 'swift',
-    'test', 'ui',
+    'test', 'test-schema', 'ui',
     'modelica', 'visualforce', 'vm', 'xml'].flat_map {|m| [m, "pmd-" + m]}
 
   def self.make_base_namespaces

docs/pages/pmd/userdocs/extending/testing.md

@@ -135,14 +135,18 @@ between different test cases.
 
 The `<test-code>` elements understands the following optional attributes:
 
-* **reinitializeRule**: By default, it's `true`, so each test case starts with a fresh instantiated rule. Set it
-    to `false` to reproduce cases, where the previous run has influences.
+* **disabled**: By default, it's `false`. Set it to `true`, to ignore and skip a test case.
 
-* **disabled**: By default, it's `false`. Set ti to `true`, to ignore and skip a test case.
+* **focused**: By default, it's `false`. Set it to `true`, to ignore all other test cases.
 
-* **useAuxClasspath**: By default, it's `true`. Set it to `false` to reproduce issues which only
+* **useAuxClasspath**: _deprecated since PMD 6.48.0: assumed true, has no effect anymore._
+    By default, it's `true`. Set it to `false` to reproduce issues which only
     appear without type resolution.
 
+* **reinitializeRule**: _deprecated since PMD 6.48.0: assumed true, has no effect anymore._
+    By default, it's `true`, so each test case starts with a fresh instantiated rule. Set it
+    to `false` to reproduce cases, where the previous run has influences.
+
 * **regressionTest**: _deprecated since PMD 6.48.0: Use `disabled` instead. Note: It has the opposite boolean
   semantic._ By default, it's `true`. Set it to `false`, to ignore and skip a test case.
 

docs/pages/release_notes.md

@@ -54,6 +54,7 @@ Being based on a proper Antlr grammar, CPD can:
 * java-performance
     * [#3625](https://github.com/pmd/pmd/issues/3625): \[java] AddEmptyString - false negative with empty var
 * test
+    * [#3302](https://github.com/pmd/pmd/pull/3302): \[test] Improve xml test schema
     * [#3758](https://github.com/pmd/pmd/issues/3758): \[test] Move pmd-test to java 8
     * [#3976](https://github.com/pmd/pmd/pull/3976): \[test] Extract xml schema module
 
@@ -65,8 +66,12 @@ Being based on a proper Antlr grammar, CPD can:
   this module for testing your own custom rules, you'll need to make sure to use at least Java 8.
 * The new module "pmd-test-schema" contains now the XSD schema and the code to parse the rule test XML files. The
   schema has been extracted in order to easily share it with other tools like the Rule Designer or IDE plugins.
-* The attribute `isRegressionTest` is deprecated and the new attribute `disabled` should be used instead for
-  defining whether a rule test should be skipped or not.
+* Test schema changes:
+    * The attribute `isRegressionTest` of `test-code` is deprecated. The new
+    attribute `disabled` should be used instead for defining whether a rule test should be skipped or not.
+    * The attributes `reinitializeRule` and `useAuxClasspath` of `test-code` are deprecated and assumed true.
+    They will not be replaced.
+    * The new attribute `focused` of `test-code` allows disabling all tests except the focused one temporarily.
 * More information about the rule test framework can be found in the documentation:
   [Testing your rules](pmd_userdocs_extending_testing.html)
 
@@ -77,6 +82,8 @@ Being based on a proper Antlr grammar, CPD can:
   but it is no longer supported with Java 19 Preview.
 * The interface {% jdoc core::cpd.renderer.CPDRenderer %} is deprecated. For custom CPD renderers
   the new interface {% jdoc core::cpd.renderer.CPDReportRenderer %} should be used.
+* The class {% jdoc test::testframework.TestDescriptor %} is deprecated, replaced with {% jdoc test-schema::testframework.RuleTestDescriptor %}.
+* Many methods of {% jdoc test::testframework.RuleTst %} have been deprecated as internal API.
 
 #### Experimental APIs