Changes to look and feel of javadoc generated API pages in JDK 8

Remi Forax forax at univ-mlv.fr
Wed Nov 6 15:06:55 PST 2013


On 11/06/2013 10:43 PM, Bhavesh Patel wrote:
> Hi All,
>         Based on the feedback received on the new UI implementation in JDK 7 javadoc, we have made some minor changes to look and feel of the API pages generated by javadoc in JDK 8. The JDK API documentation pages will be using DejaVu font. A sample build, using the DejaVu fonts, can be found at http://cr.openjdk.java.net/~bpatel/docs/dejaVu/api/. Non-JDK API documentation pages that are generated by the user of the javadoc tool will be using non-DejaVu fonts as specified in the stylesheet.css file. A sample build can be found at http://cr.openjdk.java.net/~bpatel/docs/api/.
>         Please provide any feedback, that you might have, on these new look and feel changes in both the versions.
>
> Regards,
> Bhavesh.

Both docs are quite nice :)

Just nitpicking a little:
   In the header, the summary always shows all the selector NESTED, 
FIELD, CONSTR etc
   but the method summary only show the tab if needed.
   I think that the header summary should only show the selector if 
nested classes or fields etc exist.

   The way the compact profiles are displayed is too close to the way 
the package is displayed,

   If the method doc uses a lighter gray, the text of the parameters, 
returns and throws should use light gray too.

cheers,
Rémi





More information about the jdk8-dev mailing list