WordPress.org

Making WordPress.org

Opened 2 years ago

Closed 2 years ago

Last modified 2 years ago

#3562 closed enhancement (fixed)

misleading string on how to report a11y issues

Reported by: Presskopp Owned by: obenland
Milestone: Priority: normal
Component: Handbooks Keywords:
Cc:

Description

To report an Accessibility issue you’ve encountered in WordPress or on WordPress.org, please see the Accessibility Handbook on <a href="%s">Reporting Accessibility Issues</a>.

I think this is not correct, bacause the link brings you to https://make.wordpress.org/accessibility/handbook/reporting-issues

and there is no handbook but it's a sub part of the handbook. I propose to just use:

To report an Accessibility issue you’ve encountered in WordPress or on WordPress.org, please see <a href="%s">Reporting Accessibility Issues</a>.

Change History (6)

#1 @SergeyBiryukov
2 years ago

The existing string looks good to me, it explains where the link goes. "on" means "on the topic of" here, not that the page itself is the handbook.

It could probably be made a bit clearer with:

  • "please see the Accessibility Handbook page on <a href="%s">Reporting Accessibility Issues</a>".

or:

  • "please see the <a href="%s">Reporting Accessibility Issues</a> page in Accessibility Handbook".
Last edited 2 years ago by SergeyBiryukov (previous) (diff)

#2 @Presskopp
2 years ago

"on" means "on the topic of" here, not that the page itself is the handbook.

uh, oops, yes, now I see. But if I found it misleading, some others could be trapped the same way, so let's improve it, like you said.

Last edited 2 years ago by Presskopp (previous) (diff)

#3 @obenland
2 years ago

  • Owner set to obenland
  • Resolution set to fixed
  • Status changed from new to closed

In 7456:

Main: Clarify how to report a11y issues.

Props SergeyBiryukov, Presskopp.
Fixes #3562.

#4 follow-up: @Presskopp
2 years ago

Thank you.

A note:
The heading is "Report accessibility issues" while we link to "Reporting Accessibility Issues"

#5 in reply to: ↑ 4 @dd32
2 years ago

Replying to Presskopp:

The heading is "Report accessibility issues" while we link to "Reporting Accessibility Issues"

That seems fine to me, the link text is describing what you'll find on the page, not necessarily the exact title of said page.

#6 @Presskopp
2 years ago

well, ok :) just stumbled upon

Note: See TracTickets for help on using tickets.