Uploaded image for project: 'WildFly'
  1. WildFly
  2. WFLY-16755

Update documentation to reflect the new Jakarta Specifications and change namespaces

XMLWordPrintable

    • Icon: Task Task
    • Resolution: Done
    • Icon: Blocker Blocker
    • 27.0.0.Final
    • None
    • Documentation
    • None

      Documentation needs to be analyzed to determine the following:

      1. Do we need to document compatibility changes for spec X?
      2. What examples/code snippets need to have package/signature changes?
      3. Define the new specification versions where applicable.
      4. Change "Jakarta EE 8" references to "Jakarta EE 10". Or better yet remove the version reference.
      5. Check the minimum requirements, e.g. Java version, section.

      This list may or may not grow, but those are the basic places to start. We could consider breaking this into components if that makes sense. Just create a new JIRA and make this JIRA it's "is parent of".

      Do note that asciidoc does support variables and we should use those where applicable.

        1. WFLY-16755.txt
          34 kB

            [WFLY-16755] Update documentation to reflect the new Jakarta Specifications and change namespaces

            Brian Stansberry added a comment - - edited

            Completed portions:

            EJB docs - https://github.com/wildfly/wildfly/pull/16210
            JPA docs – https://github.com/wildfly/wildfly/pull/16212
            JTA docs – https://github.com/wildfly/wildfly/pull/16214
            Webservices docs – https://github.com/wildfly/wildfly/pull/16211
            Misc other docs – https://github.com/wildfly/wildfly/pull/16217

            Overall spec list: https://github.com/wildfly/wildfly/pull/16231

            Brian Stansberry added a comment - - edited Completed portions: EJB docs - https://github.com/wildfly/wildfly/pull/16210 JPA docs – https://github.com/wildfly/wildfly/pull/16212 JTA docs – https://github.com/wildfly/wildfly/pull/16214 Webservices docs – https://github.com/wildfly/wildfly/pull/16211 Misc other docs – https://github.com/wildfly/wildfly/pull/16217 Overall spec list: https://github.com/wildfly/wildfly/pull/16231

            Brian Stansberry added a comment -

            I've attached the output of this command, meant to roughly show uses of EE 8 API names in the docs module. (This was run from the docs module.)

            git grep javax | grep -v javax\.sql | grep -v javax\.management | grep -v javax\.naming | grep -v javax\.net

            Note that https://issues.redhat.com/browse/WFLY-17126 and https://issues.redhat.com/browse/WFLY-16731 will handle the WildFly_and_WildFly_Preview.adoc and H2_Web_Console_Integration.adoc files on there.

            Brian Stansberry added a comment - I've attached the output of this command, meant to roughly show uses of EE 8 API names in the docs module. (This was run from the docs module.) git grep javax | grep -v javax\.sql | grep -v javax\.management | grep -v javax\.naming | grep -v javax\.net Note that https://issues.redhat.com/browse/WFLY-17126 and https://issues.redhat.com/browse/WFLY-16731 will handle the WildFly_and_WildFly_Preview.adoc and H2_Web_Console_Integration.adoc files on there.

              bstansbe@redhat.com Brian Stansberry
              jperkins-rhn James Perkins
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

                Created:
                Updated:
                Resolved: