Changes to look and feel of javadoc generated API pages in JDK 8
Mike Duigou
mike.duigou at oracle.com
Wed Nov 6 14:58:19 PST 2013
This looks like a nice refinement.
Some immediate bits of feedback:
- The size of <pre> and {@code } elements differs. (14.4px vs 14px). This is also a problem with the existing templates.
- Why px for most but not all measurements? I would personally prefer to see em units used to tie sizing of elements to user's preferences. (http://www.w3.org/WAI/GL/css2em.htm) At minimum, use either all px or all em. To see badness, drastically adjust the size of your default font. E A few UI elements will now look weird (Trademarks, legal text, height of nav bars, etc.
- All of the text could be somewhat higher contrast. #666666 is too low for body copy. Perhaps it's just the Deja Vu font. I keep thinking the text is transparent.
- Verdana would be preferable to Arial as a fallback for headings.
Mike
On Nov 6 2013, at 13:43 , Bhavesh Patel <bhavesh.x.patel at oracle.com> 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.
More information about the jdk8-dev
mailing list