RFR: 8345348: CSS media feature queries [v20]

[Andy Goryachev]

On Tue, 6 May 2025 07:07:20 GMT, Michael Strauß <mstrauss at openjdk.org> wrote:

>> modules/javafx.graphics/src/main/docs/javafx/scene/doc-files/cssref.html line 871:
>> 
>>> 869:             <code>(prefers-color-scheme: dark) and (prefers-reduced-motion) or (prefers-reduced-transparency)</code>
>>> 870:             is illegal, as it is unclear what was meant. In this case, parentheses must be used to group expressions.
>>> 871:     </ul>
>> 
>> maybe one or two examples would be helpful here.
>
> I don't want to overload cssref with too many examples, as this is not supposed to be a general-purpose CSS documentation. The media query doc is already quite comprehensive as it is. For detailed information, there's always the W3C specification, and hundreds of third-party sources.

I insist: the doc should include an example with an operator, and possibly how to achieve A and not B case mentioned earlier.

Assume the reader has no clue how media queries work and does not want to wade through the massive and unrelated w3.org spec.  The `cssref.html` should be self-sufficient in that sense, in my opinion.

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

PR Review Comment: https://git.openjdk.org/jfx/pull/1655#discussion_r2075729576