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