On branch edburns/20250312-copyedits

glassfish-runner/README.md

@@ -0,0 +1,52 @@
+* Directories containing the keyword `extra` are runners for tests
+  that must be run in addition to that component tck.
+
+   As of 2025-03-12, this is:
+
+   - cdi-platform-extra-tck
+   - jsonb-platform-extra-tck
+   - jsonp-platform-extra-tck
+   - pages-platform-extra-tck
+   - rest-platform-extra-tck
+   - websocket-platform-extra-tck
+
+* Directories containing the keyword `subst` are runners for tests
+  where the component TCK completely replaces the component tck. In
+  other words, the component TCK can be completely ignored.
+
+   As of 2025-03-12, this is:
+
+   - expression-language-platform-subst-tck
+
+* Directories that do not contain either of the preceding keywords
+  contain runners for tests where component TCK is the necessary and
+  sufficient set of tests. These tests are produced and published by
+  the respective component specification project.
+
+   As of 2025-03-12, this is:
+
+   - annotations-tck
+   - batch-tck
+   - cdi-model-tck
+   - cdi-tck
+   - concurrency-tck
+   - connector-platform-tck
+   - data-tck
+   - enterprise-beans-tck
+   - expression-language-tck
+   - jsonb-tck
+   - jsonp-tck
+   - mail-platform-tck
+   - messaging-platform-tck
+   - messaging-tck
+   - pages-tck
+   - persistence-platform-tck
+   - persistence-tck
+   - platform
+   - rest-tck
+   - servlet-tck
+   - signature
+   - tags-tck
+   - transactions-tck
+   - validation-tck
+   - websocket-tck

tcks/profiles/platform/docs/userguide/platform/src/main/asciidoc/install.adoc

@@ -5,7 +5,7 @@
 This chapter explains how to install the Jakarta EE {tck_version} Platform TCK software and
 perform a sample test run to verify your installation and familiarize
 yourself with the TCK. Installation instructions are provided for Eclipse
-<glassfish_version>, a Compatible Implementation (CI) of Jakarta EE. If you are using
+{glassfish_version}, a Ratifying Compatible Implementation (CI) of Jakarta EE. If you are using
 another compatible implementation, refer to instructions provided with that
 implementation.
 
@@ -50,13 +50,13 @@ EE {tck_version} CI.
 == Installing the Jakarta EE {tck_version} Platform TCK
 
 Complete the following procedure to install the Jakarta EE {tck_version} Platform TCK on a
-system running the Solaris, Linux, or Windows operating system.
+system running the Solaris, GNU/Linux, or Windows operating system.
 
 
 [NOTE]
 ======================================================================
 
-When installing in the Windows environment, the Jakarta EE {tck_version} CI, Java SE 8
+When installing in the Windows environment, the Jakarta EE {tck_version} CI, Java SE
 JDK, and TCK should be installed on the same drive. If you must install
 these components on different drives, be sure to change the
 `ri.applicationRoot` and `s1as.applicationRoot` properties as needed in
@@ -95,4 +95,4 @@ When run with no arguments this downloads the Jakarta EE staging repository arti
 [source,bash]
 ----
 java VerifyHashes.java https://repo1.maven.org/maven2/jakarta/tck/
-----
+----

tcks/profiles/platform/docs/userguide/platform/src/main/asciidoc/intro.adoc

@@ -356,45 +356,43 @@ Linux software that meet the following software requirements:
 [[additional-jakarta-ee-platform-tck-requirements]]
 == Additional Jakarta EE {tck_version} Platform TCK Requirements
 
-// edburns check these versions and links please
 In addition to the instructions and requirements described in this
-document, all Jakarta EE {tck_version} Platform implementations must also pass the standalone TCKs for the following technologies:
-
-* Jakarta Activation -- see https://jakarta.ee/specifications/activation/ for additional details
-* Jakarta Authentication -- see https://jakarta.ee/specifications/authentication/3.1/ for additional details
-* Jakarta Batch -- see https://jakarta.ee/specifications/batch/2.1/ for additional details
-* Jakarta Bean Validation -- see https://jakarta.ee/specifications/bean-validation/3.1/ for additional details
-* Jakarta Concurrency -- see https://jakarta.ee/specifications/concurrency/3.1/ for additional details
-* Jakarta Contexts and Dependency Injection (including Language Model TCK) -- see https://jakarta.ee/specifications/cdi/4.1/ for additional details
-* Jakarta Data -- see https://jakarta.ee/specifications/data/1.0/
-* Jakarta Debugging Support for Other Languages -- see https://jakarta.ee/specifications/debugging/ for additional details
-* Jakarta Dependency Injection -- see https://jakarta.ee/specifications/dependency-injection/2.0/ , for additional details
-* Jakarta Faces -- see https://jakarta.ee/specifications/faces/4.0/ for additional details
-* Jakarta JSON Binding -- see https://jakarta.ee/specifications/jsonb/3.0/ for additional details
-* Jakarta JSON Processing -- see https://jakarta.ee/specifications/jsonp/2.1/ for additional details
-* Jakarta Mail -- see https://jakarta.ee/specifications/mail/2.1/ for additional details
-* Jakarta RESTFul Web Services -- see https://jakarta.ee/specifications/restful-ws/4.0/ for additional details
-* Jakarta Security -- see https://jakarta.ee/specifications/security/4.0/ for additional details
-* Jakarta Servlet -- see https://jakarta.ee/specifications/servlet/6.1/ for additional details
-* Jakarta WebSocket -- see https://jakarta.ee/specifications/websocket/2.2/ for additional details
+document, all Jakarta EE {tck_version} Platform implementations must also pass the standalone TCKs for the following technologies. See the links for additional details.
+
+* Jakarta Activation -- https://jakarta.ee/specifications/activation/2.1/
+* Jakarta Authentication -- https://jakarta.ee/specifications/authentication/3.1/
+* Jakarta Batch -- https://jakarta.ee/specifications/batch/2.1/
+* Jakarta Bean Validation -- https://jakarta.ee/specifications/bean-validation/3.1/
+* Jakarta Concurrency -- https://jakarta.ee/specifications/concurrency/3.1/
+* Jakarta Contexts and Dependency Injection (including Language Model TCK) -- https://jakarta.ee/specifications/cdi/4.1/
+* Jakarta Data -- https://jakarta.ee/specifications/data/1.0/
+* Jakarta Debugging Support for Other Languages -- https://jakarta.ee/specifications/debugging/2.0/
+* Jakarta Dependency Injection -- https://jakarta.ee/specifications/dependency-injection/2.0/
+* Jakarta Faces -- https://jakarta.ee/specifications/faces/4.1/
+* Jakarta JSON Binding -- https://jakarta.ee/specifications/jsonb/3.0/
+* Jakarta JSON Processing -- https://jakarta.ee/specifications/jsonp/2.1/
+* Jakarta Mail -- https://jakarta.ee/specifications/mail/2.1/
+* Jakarta RESTFul Web Services -- https://jakarta.ee/specifications/restful-ws/4.0/
+* Jakarta Security -- https://jakarta.ee/specifications/security/4.0/
+* Jakarta Servlet -- https://jakarta.ee/specifications/servlet/6.1/
+* Jakarta WebSocket -- https://jakarta.ee/specifications/websocket/2.2/
 
 All Jakarta EE {tck_version} Web Profile implementations must also pass the standalone TCKs for the following technologies:
 
-// edburns check these versions and links please
-* Jakarta Authentication -- see https://jakarta.ee/specifications/authentication/3.1/ for additional details
-* Jakarta Bean Validation -- see https://jakarta.ee/specifications/bean-validation/3.1/ for additional details
-* Jakarta Concurrency -- see https://jakarta.ee/specifications/concurrency/3.1/ for additional details
-* Jakarta Contexts and Dependency Injection (including Language Model TCK) -- see https://jakarta.ee/specifications/cdi/4.1/ for additional details
-* Jakarta Data -- see https://jakarta.ee/specifications/data/1.0/
-* Jakarta Debugging Support for Other Languages -- see https://jakarta.ee/specifications/debugging/ for additional details
-* Jakarta Dependency Injection -- see https://jakarta.ee/specifications/dependency-injection/2.0/ for additional details
-* Jakarta Faces -- see https://jakarta.ee/specifications/faces/4.0/ for additional details
-* Jakarta JSON Binding -- see https://jakarta.ee/specifications/jsonb/3.0/ for additional details
-* Jakarta JSON Processing -- see https://jakarta.ee/specifications/jsonp/2.1/ for additional details
-* Jakarta RESTFul Web Services -- see https://jakarta.ee/specifications/restful-ws/4.0/ for additional details
-* Jakarta Security -- see https://jakarta.ee/specifications/security/4.0/ for additional details
-* Jakarta Servlet -- see https://jakarta.ee/specifications/servlet/6.1/ for additional details
-* Jakarta WebSocket -- see https://jakarta.ee/specifications/websocket/2.2/ for additional details
+* Jakarta Authentication -- https://jakarta.ee/specifications/authentication/3.1/
+* Jakarta Bean Validation -- https://jakarta.ee/specifications/bean-validation/3.1/
+* Jakarta Concurrency -- https://jakarta.ee/specifications/concurrency/3.1/
+* Jakarta Contexts and Dependency Injection (including Language Model TCK) -- https://jakarta.ee/specifications/cdi/4.1/
+* Jakarta Data -- https://jakarta.ee/specifications/data/1.0/
+* Jakarta Debugging Support for Other Languages -- https://jakarta.ee/specifications/debugging/
+* Jakarta Dependency Injection -- https://jakarta.ee/specifications/dependency-injection/2.0/
+* Jakarta Faces -- https://jakarta.ee/specifications/faces/4.0/
+* Jakarta JSON Binding -- https://jakarta.ee/specifications/jsonb/3.0/
+* Jakarta JSON Processing -- https://jakarta.ee/specifications/jsonp/2.1/
+* Jakarta RESTFul Web Services -- https://jakarta.ee/specifications/restful-ws/4.0/
+* Jakarta Security -- https://jakarta.ee/specifications/security/4.0/
+* Jakarta Servlet -- https://jakarta.ee/specifications/servlet/6.1/
+* Jakarta WebSocket -- https://jakarta.ee/specifications/websocket/2.2/
 
 
 [[getting-started-with-the-jakarta-ee-platform-tck-test-suite]]

tcks/profiles/platform/docs/userguide/platform/src/main/asciidoc/jms-resource-adaptr.adoc

@@ -28,7 +28,7 @@ components:
 Complete the following steps to set up Eclipse {glassfish_version} in your environment:
 
 1.  Set the following environment variables in your shell environment:
-* JAVA_HOME to the directory where the Java SE 8 software has been
+* JAVA_HOME to the directory where the Java SE software has been
 installed
 * JAKARTAEE_HOME to the directory where the Jakarta EE {tck_version} CI (Eclipse {glassfish_version}) software has been
 installed

tcks/profiles/platform/docs/userguide/platform/src/main/asciidoc/rules-wp.adoc

@@ -1,6 +1,5 @@
 [[procedure-for-jakarta-platform-enterprise-edition-web-profile-certification]]
 = Procedure for Jakarta Platform, Enterprise Edition 11 Web Profile Certification
-(Needs Refectoring with the rules.adoc)
 
 This chapter describes the compatibility testing procedure and
 compatibility requirements for Jakarta Platform, Enterprise Edition Version {tck_version} Web Profile.
@@ -90,7 +89,7 @@ typically by means such as marketing materials, product documentation,
 usage messages, or developer support programs.
 
 |Edition |A Version of the Java Platform. Editions include Java Platform
-Standard Edition and Java Platform Enterprise Edition.
+Standard Edition and Jakarta Platform Enterprise Edition.
 
 |Endorsed Standard |A Java API defined through a standards process other
 than the Jakarta Enterprise Specification Process. The Endorsed Standard packages are
@@ -99,7 +98,7 @@ listed later in this chapter.
 |Excluded Tests |Each release of a TCK may include tests that are annotated as excluded. These tests are not required to be run by the TCK user.
 
 
-|Jakarta Server Page |A text-based document that uses Jakarta Server Pages technology.
+|Jakarta Server Page |A text-based document that uses Jakarta Pages technology.
 
 |Jakarta Server Page Implementation Class |A program constructed by transforming
 the Jakarta Server Page text into a Java language program using the transformation
@@ -213,7 +212,7 @@ performance, then that Product must satisfy all applicable compatibility
 requirements for a Product in each Product Configuration, and
 combination of Product Configurations, of those Operating Modes.
 
-EE-WP1.1 Each implementation must have at least one configuration that can be used to pass all required TCK Tests, although such configuration may need adjustment (e.g. whether statically or via administrative tooling).
+EE-WP1.1 Each implementation must have at least one Product Configuration that can be used to pass all required TCK Tests, although such configuration may need adjustment (e.g. whether statically or via administrative tooling).
 
 EE-WP1.2 An implementation may have mode(s) that provide compatibility with previous Jakarta EE versions.
 
@@ -345,18 +344,22 @@ EE-WP21 Compliance testing for Jakarta EE {tck_version} Web Profile consists of
 
 [[standalone-tcks-wp]]
 * Jakarta Authentication
-* Jakarta Bean Validation
 * Jakarta Concurrency
 * Jakarta Contexts and Dependency Injection
 * Jakarta Data
 * Jakarta Debugging Support for Other Languages
 * Jakarta Dependency Injection
 * Jakarta Faces
+* Jakarta Pages
 * Jakarta JSON Binding
 * Jakarta JSON Processing 
 * Jakarta RESTful Web Services
 * Jakarta Security
 * Jakarta Servlet
+* Jakarta Tags (contained within the platform TCK)
+* Jakarta Transactions
+* Jakarta Validation
+* Jakarta WebSocket 
 
 See <<additional-jakarta-ee-platform-tck-requirements>> for additional information on the component specification TCKs.
 
@@ -383,7 +386,7 @@ site at `https://jakarta.ee/specifications/webprofile/11/`. You may also find in
 The following location provides a list of packages that constitute the
 required class libraries for the full Java EE {tck_version} platform:
 
-``https://projects.eclipse.org/projects/ee4j.jakartaee-platform`
+`https://projects.eclipse.org/projects/ee4j.jakartaee-platform`
 
 The following list constitutes the subset of Jakarta EE {tck_version} packages that are
 required for the Jakarta EE {tck_version} Web Profile:
@@ -475,8 +478,3 @@ required for the Jakarta EE {tck_version} Web Profile:
 * jakarta.security.enterprise.authentication.mechanism.http
 * jakarta.security.enterprise.credential
 * jakarta.security.enterprise.identitystore
-* jakarta.xml.bind (optional)
-* jakarta.xml.bind.annotation (optional)
-* jakarta.xml.bind.annotation.adapters (optional)
-* jakarta.xml.bind.attachment (optional)
-* jakarta.xml.bind.util (optional)

tcks/profiles/platform/docs/userguide/platform/src/main/asciidoc/rules.adoc

@@ -96,15 +96,15 @@ typically by means such as marketing materials, product documentation,
 usage messages, or developer support programs.
 
 |Edition |A Version of the Java Platform. Editions include Java Platform
-Standard Edition and Java Platform Enterprise Edition.
+Standard Edition and Jakarta Platform Enterprise Edition.
 
 |Endorsed Standard |A Java API defined through a standards process other
 than the Jakarta Enterprise Specification Process. The Endorsed Standard packages are
 listed later in this chapter.
 
 |Excluded Tests |Each release of a TCK may include tests that are annotated as excluded. These tests are not required to be run by the TCK user.
 
-|Jakarta Server Page |A text-based document that uses Jakarta Server Pages technology.
+|Jakarta Server Page |A text-based document that uses Jakarta Pages technology.
 
 |Jakarta Server Page Implementation Class |A program constructed by transforming
 the Jakarta Server Page text into a Java language program using the transformation
@@ -164,7 +164,7 @@ specification defined artifacts. Rebuilding and running these tests
 against a known compatible implementation verifies that the
 mechanism generates compatible artifacts.
 
-|Compatible Implementation (CI) |A verified compatible implementation 
+|Compatible Implementation (CI) |A ratified compatible implementation 
 of a Specification.
 
 |Resource |A Computational Resource, a Location Resource, or a Security
@@ -217,7 +217,7 @@ performance, then that Product must satisfy all applicable compatibility
 requirements for a Product in each Product Configuration, and
 combination of Product Configurations, of those Operating Modes.
 
-EE1.1 Each implementation must have at least one configuration that can be used to pass
+EE1.1 Each implementation must have at least one Product Configuration that can be used to pass
 all required TCK Tests, although such configuration may need adjustment (e.g. whether statically
 or via administrative tooling).
 
@@ -528,9 +528,4 @@ required for Jakarta EE {tck_version}.0:
 * jakarta.ws.rs.core
 * jakarta.ws.rs.ext
 * jakarta.ws.rs.sse
-* jakarta.xml.bind (optional)
-* jakarta.xml.bind.annotation (optionsl)
-* jakarta.xml.bind.annotation.adapters (optional)
-* jakarta.xml.bind.attachment (optional)
-* jakarta.xml.bind.util (optional)