RFR: 8340203: Link color is hard to distinguish from text color in API documentation

Hannes Wallnöfer hannesw at openjdk.org
Tue Oct 8 14:33:41 UTC 2024


Please review a CSS-only change to make it easier to recognize links in API documentation with the default stylesheet. 

This subtle change makes the link color a bit lighter and more saturated and normal text a bit darker. The new link color is `#437291` which is the same color used for links on [openjdk.org](https://openjdk.org/) and other OpenJDK sites. 

The table of contents and breadcrumb-navigation uses a slightly darker color closer to the original one, which works better with the gray background and the large amount of links.

The change also introduces CSS variables (aka custom properties) for the TOC colors which have been missing, and removes some redundant CSS rules for the TOC header.

I've uploaded API docs for `java.base` to compare the changes:

New colors: https://cr.openjdk.org/~hannesw/8340203/api.00/java.base/java/lang/Thread.html
Old colors: https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/lang/Thread.html

-------------

Commit messages:
 - JDK-8340203: Link color is hard to distinguish from text color in API documentation

Changes: https://git.openjdk.org/jdk/pull/21409/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=21409&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8340203
  Stats: 13 lines in 1 file changed: 6 ins; 3 del; 4 mod
  Patch: https://git.openjdk.org/jdk/pull/21409.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/21409/head:pull/21409

PR: https://git.openjdk.org/jdk/pull/21409


More information about the javadoc-dev mailing list