elharo commented on code in PR #68:
URL: https://github.com/apache/xerces-j/pull/68#discussion_r2564789680
##########
src/org/apache/xerces/xs/datatypes/package.html:
##########
@@ -27,6 +27,7 @@
<BR>
<BR>
<TABLE border="1">
+ <caption>Mappings between XML Schema Data Type and applicable
interfaces</caption>
Review Comment:
Be careful. Per Gemini, "The role='presentation' attribute used on an HTML
<table> element is an ARIA (Accessible Rich Internet Applications) attribute
that instructs assistive technologies, such as screen readers, to disregard the
element's implicit semantic role.
Purpose:
When applied to a <table> element, role='presentation' tells screen readers
to treat the table as purely presentational markup for layout purposes, rather
than a data table with meaningful row and column relationships. This prevents
screen readers from announcing the table's structure (e.g., "table with X rows
and Y columns") and instead allows them to linearize the content, reading it in
a more natural, sequential order.
When to Use:
Layout Tables:
This attribute is primarily intended for tables used solely for visual
layout, where the content within the table does not have a logical,
two-dimensional structure that requires table semantics for understanding."
so if that's the case for a given table, fine. But it's not the case for all
tables. Adding it purely to silence a mistaken warning is not a good idea.
Bottom line is that some of these warnings doclint emits are simply wrong.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
