open-indy / Koa11y

Easily check for website accessibility issues
https://open-indy.github.io/Koa11y
MIT License
436 stars 26 forks source link

What is the importance of warnings and notices #41

Closed jasan-s closed 6 years ago

jasan-s commented 6 years ago

I may have missed this but I couldn't find info regarding the matter. Errors in the report are clear that need fixing. but what what about the warnings and notices? Do they require fixing to be compliant?

TheJaredWilcurt commented 6 years ago

For example, a <table> that is used to display tabular data (like an excel spreadsheet), should have a caption associated with it to summarize the table's contents. However if the <table> is being used for page layout reasons, then no caption is required. The context of how you are using the table is difficult to accurately understand programmatically, so a notice is issued to instruct you to look into the context of this code to determine if it is in violation.

Under the hood Koa11y uses Pa11y to detect these Errors/Warnings/Violations. But if you dig deeper, Pa11y is actually using HTML_CodeSniffer. HTML_CodeSniffer is what is generating the distinction between Errors, Warnings, and Notices. You can read more here: