RFR: 8378366: Accessibility issues in CSS Reference Guide and Introduction to FXML

[Kevin Rushforth]

On Fri, 20 Feb 2026 23:56:53 GMT, Alexander Zuev <kizune at openjdk.org> wrote:

> The question is: is table a proper format for this particular type of information?

I think a table is the right format for this information. As @mstr2 mentioned in his above comment:

> I'd say that this is semantically more like a table than it is like a list. The left column contains the keywords, and the right column contains the descriptions.

This matches my thinking as well. So if we can satisfy the a11y requirements and keep them as tables, that would be preferable. If not, we can consider -- as a fallback -- what Andy originally proposed for this release: Change it to a bulleted list, and consider various alternatives as a follow-on fix for JavaFX 27. I'd prefer to keep it as a table.

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

PR Comment: https://git.openjdk.org/jfx/pull/2082#issuecomment-3937709933