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]
