Skip to content
This repository has been archived by the owner on Jan 30, 2023. It is now read-only.

Many sentences are more complex than they probably need to be. #18

Open
ericherman opened this issue May 31, 2022 · 0 comments
Open

Many sentences are more complex than they probably need to be. #18

ericherman opened this issue May 31, 2022 · 0 comments

Comments

@ericherman
Copy link
Member

ericherman commented May 31, 2022

Having reviewed the contents, I see a number of places where I suspect sentences could be simplified without losing meaning.

Thinking about the Standard for Public Code, and the requirement :

Documentation SHOULD aim for a lower secondary education reading level, as recommended by the Web Content Accessibility Guidelines 2.

I believe we can and should take a pass through the contents with an effort to simplify sentences where possible. When we took that approach with the Standard itself, we all felt the changes were improvements.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant