[wp-trac] [WordPress Trac] #58573: Site Health: Improve the speak() messages

[WordPress Trac]

#58573: Site Health: Improve the speak() messages
---------------------------+-----------------------------
 Reporter:  afercia        |      Owner:  (none)
     Type:  defect (bug)   |     Status:  new
 Priority:  normal         |  Milestone:  Awaiting Review
Component:  Site Health    |    Version:
 Severity:  normal         |   Keywords:  has-screenshots
  Focuses:  accessibility  |
---------------------------+-----------------------------
 When the Site Health tests run, a few audible messages are sent to the
 `speak()`  ARIA live regions. These messages are announced by screen
 readers and provide users with audibel feedback about what's going on.

 However, I'm not sure the current messages provide users with the best
 experience, as they are somehow confusing and sometimes they seems to
 happen in an incorrect order.

 Note: in the screenshots below, I'm using a small plugin to dump to the
 console the audible messages text, to better illustrate what screen reader
 users get.

 1
 When the admin Dashboard page loads, the Site Health widget triggers two
 audible messages. They have the same text:

 ```
 All site health tests have finished running. Your site is looking good,
 and the results are now available on the page.
 ```

 - I found this message confusing: as a user, I just landed on the
 Dashboard and I have no idea why I'm getting messages related to this
 think called 'Site Health'. Actually I may not even know what Site Health
 is.
 - The message text says that 'the results are now available on the page'.
 What page? There are no results on the Dashboard page.

 2
 Tools > Site Health > Status
 - Visually, some text at the top informs sighted users that `Results are
 still loading…`. There's no equivalent info for screen reader users. It is
 worth considering to add a speak message to provide an equivalent
 information to screen reader users.
 - When all the tests results are available, a message inform users that
 `All site health tests have finished running. Your site is looking good,
 and the results are now available on the page.`. That's okay.

 3
 Tools > Site Health > Info
 This is perhaps the most confusing case. At first, two messages inform
 users that `All site health tests have finished running. Your site is
 looking good, and the results are now available on the page.`

 Then, a new `Please wait...` message informs that something is still
 running.

 After that, a new message informs that all results are available: `All
 site health tests have finished running. Your site is looking good, and
 the results are now available on the page.`

 Then, a bit unexpectedly, a new message informs again that `All site
 health tests have finished running.`


 Overall, I think all the audible feedback has room for improvements to
 make the messages:
 - better match the actual state of hte tests and the state of the UI
 - avoid repetition
 - be more concise

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/58573>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform