eclipse-ee4j / glassfish

Eclipse GlassFish
https://eclipse-ee4j.github.io/glassfish/
377 stars 143 forks source link

Update JPDA links in GlassFish docs #24746

Open arjantijms opened 7 months ago

arjantijms commented 7 months ago

Correct link is https://docs.oracle.com/en/java/javase/17/docs/specs/jpda/jpda.html

Should replace http://www.oracle.com/technetwork/java/javase/tech/jpda-141715.html

See https://github.com/eclipse-ee4j/glassfish/pull/24744

escay commented 7 months ago

I tried replacing them and then looked at all "/technetwork" links. I could improve most of them like:

Link JakartaEE
http://www.oracle.com/technetwork/java/javase/tech/jpda-141715.html Not JakartaEE. Point to Java 17: https://docs.oracle.com/en/java/javase/17/docs/specs/jpda/jpda.html
http://www.oracle.com/technetwork/java/javaee/tech/jta-138684.html https://jakarta.ee/specifications/transactions/
http://www.oracle.com/technetwork/java/javaee/tech/jts-140022.html Remove JTS text and link and just reference https://jakarta.ee/specifications/transactions/
http://www.oracle.com/technetwork/java/javaee/tech/ https://jakarta.ee/specifications/
http://www.oracle.com/technetwork/java/javaee/downloads/index.html Cannot be replaced 1:1, I do not think there is a Netbeans/JakartaEE SDK starter kit anymore. Could be rewritten and point to https://start.jakarta.ee/
http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136112.html No webstart anymore. Better to remove whole webstart chapter. Deprecated since java 9, removed in java 11.
http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136007.html https://jakarta.ee/specifications/authentication/ https://jakarta.ee/specifications/authorization/
http://www.oracle.com/technetwork/java/javaee/download-141771.html on /application-development-guide/src/main/asciidoc/securing-apps.adoc Whole Sample Application chapter should be replaced with JakartaEE samples and documentation at: https://github.com/eclipse-ee4j/jakartaee-examples
http://www.oracle.com/technetwork/java/javaee/servlet/index.html https://jakarta.ee/specifications/servlet/
http://www.oracle.com/technetwork/java/javaee/jsp/index.html https://jakarta.ee/specifications/pages/3.0/jakarta-server-pages-spec-3.0
http://www.oracle.com/technetwork/java/javase/tech/index-jsp-138795.html Java beans is not JakartaEE, remove link to java beans, it does not add much in the chapter.
http://www.oracle.com/technetwork/java/index-jsp-135995.html https://jakarta.ee/specifications/tags/
http://www.oracle.com/technetwork/java/javaee/blueprints/index.html opens https://www.oracle.com/java/technologies/java-ee-glance.html No JakartaEE best coding practices link. The link could better be removed since it does not link to any page about coding best practices.
http://www.oracle.com/technetwork/java/javase/gc-tuning-6-140523.html java 6 gc tuning Not JakartaEE. Point to Java 17: https://docs.oracle.com/en/java/javase/17/gctuning/introduction-garbage-collection-tuning.html
http://www.oracle.com/technetwork/java/javase/tech/vmoptions-jsp-140102.html JakartaEE link: Not available. Java Hotspot information does not seem 1:1 relevant for the chapter. Perhaps better to remove the hotspot references and links.
http://www.oracle.com/technetwork/java/hotspotfaq-138619.html JakartaEE link: Not available. Here probably also better to remove hotspot references.
http://www.oracle.com/technetwork/java/javase/tech/index-jsp-136373.html More hotspot focus / java 1.4,5 and 6 information. JakartaEE link: Not available.
http://www.oracle.com/technetwork/java/ergo5-140223.html JakartaEE link: Not available. This needs some rework or removal to make the chapter relevant
http://www.oracle.com/technetwork/index.html JakartaEE link: Not available. I think this very generic Java link could be removed.
http://www.oracle.com/technetwork/indexes/documentation/index.html JakartaEE link: Not available. I think this very generic Java link could be removed.
dmatej commented 7 months ago

I think most of those links should lead to Eclipse/Jakarta web, like ie. https://jakarta.ee/specifications/transactions/ or https://jakarta.ee/specifications/transactions/2.0/jakarta-transactions-spec-2.0 Oracle links are already obsoleted and under Jakarta names had to change.

escay commented 7 months ago

Updated my comment above with Eclipse/Jakarta relevant links.