Improve clarity and utility of quality reports - Githubissues

w3c / aria-practices

WAI-ARIA Authoring Practices Guide (APG)

https://www.w3.org/wai/aria/apg/

Other

1.21k stars 346 forks source link

Improve clarity and utility of quality reports #3040

Open mcking65 opened 5 months ago

mcking65 commented 5 months ago

Per discussion of APG quality reports in the June 4, 2024 meeting,

Some information is not directly related to required APG coding practices.
It is not clear which information represents a problem and which information represents good quality.

Modify the reports to better support quality goals for APG examples:

Example code implements practices documented in the APG code guide.
Examples consistently illustrate APG practices.
Example documentation is complete.