jakartaee-tutorial icon indicating copy to clipboard operation
jakartaee-tutorial copied to clipboard

Section "Packaging Resource Adapter Archives" contains redundant and repetitive information.

Open DmitriGit opened this issue 3 years ago • 1 comments

Hello,

in the section "https://eclipse-ee4j.github.io/jakartaee-tutorial/#packaging-resource-adapter-archives" :

1) the first paragraph : "..... A resource adapter can be deployed on any Jakarta EE server, much like a Jakarta EE application. A RAR file can be contained in an Enterprise Archive (EAR) file, or it can exist as a separate file."

2) and the last paragraph : "A RAR file can be deployed on the application server as a standalone component or as part of a larger application. In both cases, the adapter is available to all applications using a lookup procedure."

contain the same information.

Can I send you my version of that section that merge the content of these two similar paragraphs?

Thank you, Dmitri.

DmitriGit avatar Oct 07 '21 10:10 DmitriGit

My proposal is the following:

" Packaging Resource Adapter Archives

A Resource Adapter Archive (RAR) file stores XML files, Java classes, and other objects for Jakarta EE Connector applications.

The RAR file contains

  • A JAR file with the implementation classes of the resource adapter
  • An optional META-INF/ directory that can store an ra.xml file and/or an application server–specific deployment descriptor used for configuration purposes

A RAR file can be deployed on the application server as a standalone component (much like a Java EE application) or as part of a larger application (for example, it can be contained in an Enterprise Archive (EAR) file). In both cases, the adapter is available to all applications using a lookup procedure. "

Let me know if you like my version so I modify the corresponding "asciidoc" and commit it.

Thank you and have a nice day, Dmitri.

DmitriGit avatar Oct 08 '21 09:10 DmitriGit