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

[WordPress Trac]

#58573: Site Health: Improve the speak() messages
-----------------------------------------+----------------------------
 Reporter:  afercia                      |       Owner:  joedolson
     Type:  defect (bug)                 |      Status:  accepted
 Priority:  normal                       |   Milestone:  6.4
Component:  Site Health                  |     Version:
 Severity:  normal                       |  Resolution:
 Keywords:  has-screenshots needs-patch  |     Focuses:  accessibility
-----------------------------------------+----------------------------
Description changed by afercia:

Old description:

> 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

New description:

 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 audible 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 seem 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
 thing 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 informs 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 the tests and the state of the UI
 - avoid repetition
 - be more concise

--

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