On APIdia there are now quick-selectors for Jakarta EE 11 API docs to reduce the view to core or web profile. You can also select e.g. platform without core and web to see precisely those modules that are *only* available in the full platform profile.
#java #javadoc #jakartaee

JakartaEE 11 docs on APIdia:
https://apidia.net/mvn/jakarta.platform/jakartaee/11
Note: If you visited the site recently, it may be necessary to reload with ctrl-F5 to get this new feature working. (That forces your browser to reload cached resources such as Javascript files.)

You don't need a lot of tooling for a quick sanity check if you expose only what you want to expose from a #Java package. Generate your #Javadoc and see what it sees and publishes. Its default inclusions are just spot on.

Jakarta 11 has been released! Congrats @jakartaee and OmniFish for getting this shipped!

API documentation is readily available on APIdia:
https://apidia.net/mvn/jakarta.platform/jakartaee/11

Compared to the official Javadocs, the docs on APIdia include the module pages, yet integrated into one coherent doc profile. E.g. check the new spec jakarta-data: https://apidia.net/mvn/jakarta.platform/jakartaee/11.0.0/?pck=jakarta.data-all-classes&cls=jakarta.data-module

#java #javadoc #jakartaee #jdk

libGDX is a Java game development framework with exceptional cross-platform support: It supports building for Desktop, Android, iOS and Browsers/HTML5 from a single consistent Java codebase.
API docs of its latest release can be browsed on APIdia:
libGDX:
https://apidia.net/mvn/com.badlogicgames.gdx/gdx-platform
Controller Extension:
https://apidia.net/mvn/com.badlogicgames.gdx-controllers/gdx-controllers
#java #javadoc #jdk #libgdx

Flexmark is a CommonMark/Markdown parser for Java, offering granular control of the parsing process, HTML rendering, emulation of other parsers, conversion modules e.g. to PDF or DOCX and a vast set of extension modules. The full flexmark module family is available on APIdia for browsing API docs in a single integrated doc profile: https://apidia.net/mvn/com.vladsch.flexmark/flexmark-all

#java #javadoc #markdown #jdk #flexmark

We made it to JFX-Central links of the week once again!
https://foojay.social/@frankdelporte/114635312724814686

Thank you, JFX-Central and all authors of the linked projects and articles, for keeping Java FX vivid and enabling Java on the frontend!
#javafx #LinksOfTheWeek #java #jdk #javadoc

Just wasted >7 hours wondering why #Maven failed to generate my JavaDoc with #PlantUML class diagrams.

The reason? For unknown reason, #UMLDoclet (a plugin for JavaDoc used to generate the diagrams) throws an IllegalArgumentException if you set #JavaDoc's output level to “verbose”. 🤡 😭

This issue is known and had supposedly been fixed in 2024 but the fix does not appear to actually work: https://github.com/talsma-ict/umldoclet/issues/633

unable to use umldoclet - Unanticipated error generating UML · Issue #633 · talsma-ict/umldoclet

With some older version this worked, at least I could generate some of those diagrams. However, within my actual project I get [loading /modules/java.desktop/javax/swing/SwingConstants.class] [load...

GitHub
Question for #OpenSource #license experts: when you ship a #JavaDoc jar, it contains some JS files that are GPL licensed. Does that impact the all over licensing of your product?

I will never understand teams that don't believe in writing #javadoc. You may think your code is SeLf dOcUmeNtIng, but it's not. It never is. It's always a lie you tell yourself.

For the love of all that is good, at the very least explain *what a class is for* and how it fits into the bigger picture.

Even if you think it's obvious. Nay, especially then!! I assure you, it won't be obvious to you in 5 years time, nor to the new guy inheriting your spaghetti in 10 years time.

#java