search

w3c / wai-website

This repository hosts the WAI Website.
https://www.w3.org/WAI/
Other
53 stars 209 forks source link

[ED-High] Plain english review required #715

Open iadawn opened 4 years ago

iadawn commented 4 years ago

The structure and form of this content is generally extremely complex with a high reading age based on the various readability metrics.

Ideally a plain English editorial sweep should be considered to significantly simplify the language.

Note: I have flagged this as High but I don't think if should block release.

daniel-montalvo commented 4 years ago

Hey Kevin,

Thanks for your comments, and for this thorough review that you are doing. Really appreciate it.

Do you mean the whole resource or what you have reviewed so far? Is it the structure that needs to be simplified? The wording? The concepts we use?

Thanks a lot.

iadawn commented 4 years ago

Sorry, I think it is more the wording and sentence structure than anything. I am finding that there is a lot of involved language and complex sentences that could be simplified.

daniel-montalvo commented 4 years ago

@iadawn

Do you think work on issues https://github.com/w3c/wai-curricula/issues/155 and https://github.com/w3c/wai-curricula/issues/153 is an example of this clean-up? Could you point me to some more examples?

Thanks.