On Thu, 6 Mar 2025 12:04:49 GMT, Nizar Benalla <nbena...@openjdk.org> wrote:
>> Hannes Wallnöfer has updated the pull request incrementally with two
>> additional commits since the last revision:
>>
>> - Changes:
>> - Adjust subnav link color to meet WCAG contrast rules
>> - Use subnav color for captions with links to meet WCAG rules
>> - Make table header work with new caption color
>> - Adjust some gaps
>> - Changes:
>> - Bring back breadcrumb highlight for current element
>> - Use default tab color for search page caption
>
> src/jdk.javadoc/share/classes/jdk/javadoc/internal/doclets/formats/html/resources/stylesheet.css
> line 827:
>
>> 825: font-size: inherit;
>> 826: }
>> 827: code {
>
> I noticed there is a duplicate `code` selector (first used in line 162), is
> this intentional?
> I also think it's odd to have `code` after `:is(h1, h2, h3, h4, h5, h6, sup,
> sub, small, big) code`
I merged the duplicate selectors.
The `:is(...) code` selector is to use inherited (natural) font size in places
where our standard code font size is not appropriate, such as in headings or
the ["Discussion" sections in
j.l.invoke.MethodHandles](https://cr.openjdk.org/~hannesw/8344301/api.06/java.base/java/lang/invoke/MethodHandles.html#exactInvoker(java.lang.invoke.MethodType)).
This wouldn't be necessary if we would use relative font size for code, but we
want a constant size in most places (text, summary lists, block tags,
signatures) which would be much harder to get with relative size.
-------------
PR Review Comment: https://git.openjdk.org/jdk/pull/23678#discussion_r1984728510
