What’s Up, Javadocs?
It doesn’t take much to make me happy — a good book, an episode of The Daily Show with John Stewart, a glass of Hawaiian Punch with white wine, perhaps even a delicately prepared veal scallopini for special occasions.
And I’m really ecstatic now that the Javadocs for NetWeaver is being revised and improved.
In case you missed it, the Javadocs for NetWeaver ’04 SPS15 were released about a week ago, with a new look and a few new tricks:
Links to other NetWeaver packages: Until now, when a class referenced another class in a package in another area of NetWeaver, there was no link to other package. Nothing. If you wanted to learn more about the other class, you had to find it yourself.
But now, for example, when wizard framework classes and interfaces reference HTMLB controls, there are links to the HTMLB Javadocs.
Even more striking, this is also true for portal and PRT APIs. So when the navigation service, wizard framework, editor framework, page builder and other APIs reference IPortalComponentRequest, you can navigate directly to this common interface.
- Links to standard Java classes: You now get links to standard Java packages. The links take you to the published Javadocs at java.sun.com.
- PRT and portal APIs united: Since most developers use PRT and portal APIs together — and don’t care that they reside on different layers of the portal — both sets of APIs are published together under Enterprise Portal.
- New format: The Javadocs are published in a new, crisp style, that conforms to SAP’s look and feel. The benefit is that they are easier to read, with special fonts and colors, more constrained use of emphasis, and better visual structure.
In addition, we are in the midst of an overhaul of the content of the Javadocs for the portal, improving the text, eliminating unused packages and creating better links. Hopefully, you will see the results in the upcoming releases.
You can find the Javadocs at http://www.sdn.sap.com/irj/sdn/javadocs.
As I told you, it doesn’t take much to make me happy.