First pass at resources (#166)

* First pass at resources

* applied feedback

Signed-off-by: Guillermo González de Agüero <z06.guillermo@gmail.com>

src/main/jbake/content/resource-creation.adoc

@@ -15,8 +15,8 @@ Resource Creation
 
 A resource is a program object that provides connections to such systems
 as database servers and messaging systems. Jakarta EE components can access
-a wide variety of resources, including databases, mail sessions, Java
-Message Service objects, and URLs. The Jakarta EE platform provides
+a wide variety of resources, including databases, mail sessions, Jakarta
+Messaging objects, and URLs. The Jakarta EE platform provides
 mechanisms that allow you to access all these resources in a similar
 manner. This chapter examines several types of resources and explains
 how to create them.

src/main/jbake/content/resource-creation002.adoc

@@ -57,7 +57,7 @@ increase performance. When it requests a connection, an application
 obtains one from the pool. When an application closes a connection, the
 connection is returned to the pool.
 
-Applications that use the Persistence API specify the `DataSource`
+Applications that use Jakarta Persistence specify the `DataSource`
 object they are using in the `jta-data-source` element of the
 `persistence.xml` file:
 

src/main/jbake/content/resource-creation003.adoc

@@ -25,8 +25,8 @@ asadmin add-resources glassfish-resources.xml
 ----
 
 The `glassfish-resources.xml` file can be created in any project using
-NetBeans IDE or by hand. Some of the JMS examples use this approach to
-resource creation. A file for creating the resources needed for the JMS
+NetBeans IDE or by hand. Some of the Jakarta Messaging examples use this approach to
+resource creation. A file for creating the resources needed for the Messaging
 simple producer example can be found in the
 `jms/simple/producer/src/main/setup` directory.
 

src/main/jbake/content/resources001.adoc

@@ -12,11 +12,11 @@ What Is a Resource Adapter?
 What Is a Resource Adapter?
 ---------------------------
 
-A resource adapter is a Jakarta EE component that implements the Jakarta EE
-Connector Architecture for a specific EIS. Examples of EISs include
+A resource adapter is a Jakarta EE component that implements the Jakarta Connectors API
+for a specific EIS. Examples of EISs include
 enterprise resource planning, mainframe transaction processing, and
-database systems. In a Jakarta EE server, the Java Message Server and
-JavaMail also act as EISs that you access using resource adapters. As
+database systems. In a Jakarta EE server, Jakarta Messaging and
+Jakarta Mail also act as EISs that you access using resource adapters. As
 illustrated in link:#GJTZO[Figure 55-1], the resource adapter
 facilitates communication between a Jakarta EE application and an EIS.
 
@@ -53,15 +53,15 @@ component.
 Management Contracts
 ~~~~~~~~~~~~~~~~~~~~
 
-The Jakarta EE Connector Architecture defines system contracts that enable
+Jakarta Connectors defines system contracts that enable
 resource adapter lifecycle and thread management.
 
 [[GIPHT]][[lifecycle-management]]
 
 Lifecycle Management
 ^^^^^^^^^^^^^^^^^^^^
 
-The Connector Architecture specifies a lifecycle management contract
+Jakarta Connectors specifies a lifecycle management contract
 that allows an application server to manage the lifecycle of a resource
 adapter. This contract provides a mechanism for the application server
 to bootstrap a resource adapter instance during the deployment or
@@ -75,7 +75,7 @@ place.
 Work Management Contract
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
-The Connector Architecture work management contract ensures that
+Jakarta Connectors work management contract ensures that
 resource adapters use threads in the proper, recommended manner. This
 contract also enables an application server to manage threads for
 resource adapters.

src/main/jbake/content/resources002.adoc

@@ -12,7 +12,7 @@ Metadata Annotations
 Metadata Annotations
 --------------------
 
-Jakarta EE Connector Architecture provides a set of annotations to minimize
+Jakarta Connectors provides a set of annotations to minimize
 the need for deployment descriptors.
 
 * The `@Connector` annotation can be used by the resource adapter
@@ -120,5 +120,5 @@ resource adapter need to be examined for annotations that specify
 deployment information.
 
 For the complete list of annotations and JavaBeans components provided
-in the Jakarta EE platform, see the Jakarta EE Connector Architecture 1.7
+in the Jakarta EE platform, see the Jakarta Connectors 1.7
 specification.

src/main/jbake/content/resources003.adoc

@@ -12,7 +12,7 @@ Common Client Interface
 Common Client Interface
 -----------------------
 
-This section explains how components use the Connector Architecture
+This section explains how components use the Jakarta Connectors
 Common Client Interface (CCI) API and a resource adapter to access data
 from an EIS. The CCI API defines a set of interfaces and classes whose
 methods allow a client to perform typical data access operations. The

src/main/jbake/content/resources004.adoc

@@ -1,21 +1,20 @@
 type=page
 status=published
-title=Using Resource Adapters with Contexts and Dependency Injection for Jakarta EE (CDI)
+title=Using Resource Adapters with Jakarta Contexts and Dependency Injection (CDI)
 next=resources005.html
 prev=resources003.html
 ~~~~~~
-Using Resource Adapters with Contexts and Dependency Injection for Jakarta EE (CDI)
-===================================================================================
+Using Resource Adapters with Jakarta Contexts and Dependency Injection (CDI)
+============================================================================
 
 [[CHDJFIGB]][[using-resource-adapters-with-contexts-and-dependency-injection-for-jakarta-ee-cdi]]
 
-Using Resource Adapters with Contexts and Dependency Injection for Jakarta EE (CDI)
------------------------------------------------------------------------------------
+Using Resource Adapters with Jakarta Contexts and Dependency Injection (CDI)
+----------------------------------------------------------------------------
 
 For details about CDI, see link:cdi-basic.html#GIWHB[Chapter 25,
-"Introduction to Contexts and Dependency Injection for Jakarta EE"] and
-link:cdi-adv.html#GJEHI[Chapter 27, "Contexts and Dependency Injection
-for Jakarta EE: Advanced Topics."]
+"Introduction to Jakarta EE Contexts and Dependency Injection"] and
+link:cdi-adv.html#GJEHI[Chapter 27, "Jakarta Contexts and Dependency Injection: Advanced Topics."]
 
 Do not specify the following classes in the resource adapter as CDI
 managed beans (that is, do not inject them), because the behavior of

src/main/jbake/content/resources005.adoc

@@ -14,15 +14,15 @@ Further Information about Resource Adapters
 
 For more information about resource adapters and annotations, see
 
-* Jakarta EE 8 Platform Specification (JSR 366):
+* Jakarta EE 8 Platform Specification:
 +
-`http://jcp.org/en/jsr/detail?id=366`
+`https://jakarta.ee/specifications/platform/`
 * Jakarta EE Connector Architecture 1.7 specification:
 +
-`http://jcp.org/en/jsr/detail?id=322`
-* EJB 3.2 specification:
+`https://jakarta.ee/specifications/connectors/1.7/`
+* Jakarta Enterprise Beans specification:
 +
-`http://jcp.org/en/jsr/detail?id=345`
-* Common Annotations for the Java Platform:
+`https://jakarta.ee/specifications/enterprise-beans/3.2/`
+* Jakarta Annotations:
 +
-`http://www.jcp.org/en/jsr/detail?id=250`
+`https://jakarta.ee/specifications/annotations/1.3/`