Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update JPDA links in GlassFish docs #24746

Open
arjantijms opened this issue Jan 15, 2024 · 3 comments
Open

Update JPDA links in GlassFish docs #24746

arjantijms opened this issue Jan 15, 2024 · 3 comments

Comments

@arjantijms
Copy link
Contributor

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 #24744

@escay
Copy link
Contributor

escay commented Feb 9, 2024

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
Copy link
Contributor

dmatej commented Feb 10, 2024

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
Copy link
Contributor

escay commented Feb 10, 2024

Updated my comment above with Eclipse/Jakarta relevant links.

escay added a commit to escay/glassfish that referenced this issue Feb 11, 2024
…hnetwork links

with their https://jakarta.ee/ where possible. Removes some outdated /
no longer working links that have no jakarta.ee counterpart but do not
affect the documentation.
arjantijms added a commit that referenced this issue Feb 12, 2024
Fixes issue #24746 replaces all http://www.oracle.com/technetwork links with their https://jakarta.ee/ counterpart where possible.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants