(Med) Content Issue: "Check headings on this page” bookmarklet needs clearer instructions ( before button) for better usability

[KosiAsabere]

Level: Medium
Page: What are Headings? - Easy Checks
Location: Under "Checking Headings" heading

Current Wording:

Checking this page
This is just for practice. Also, you can see what the check will look like on an accessible page.

Click on the button below:
Check headings on this page

Suggested Revision:

Checking this page
This is just for practice. Also, you can see what the check will look like on an accessible page.

Press the button below:
Checking this page

"Press the button to check the page's heading structure. A pop-up will appear, helping you determine if the heading levels are nested correctly and are appropriate for the content. You can close this pop-up to continue viewing the page."

Click on the button below:

Rationale:

"We need to provide more context before the bookmarklet, so users don't have to scroll back and forth to understand what's happening. This is especially important for people who need to zoom or are using mobile devices. Providing a short description of what the bookmarklet does will also be helpful to screen reader users and others, even if they cannot use the bookmarklet or are having trouble getting the tool to work. Context needs to be added before all easy check bookmarklets to improve usability.

[KosiAsabere]

Correction:

Suggested Revision:

Checking this page

This is just for practice. Also, you can see what the check will look like on an accessible page.

"Press the button below to check the page's heading structure. A pop-up will appear, helping you determine if the heading levels are nested correctly and are appropriate for the content. You can close this pop-up to continue viewing the page."

[KosiAsabere]

Not really sure about the order of the surrounding text. My focus is more so on the fact that there needs to be additional instructions/a description above the bookmark button for context. This will help some users with or without disabilities.

[iadawn]

Related to w3c/wai-easy-checks#239 and w3c/wai-easy-checks#238