Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Suggestions to improve readability #465

Open
KimPatch opened this issue Feb 11, 2022 · 1 comment
Open

Suggestions to improve readability #465

KimPatch opened this issue Feb 11, 2022 · 1 comment

Comments

@KimPatch
Copy link

Here are some subtle changes you can make to improve readability:

  1. Remove colons in cases where the text before a set of bullets is not a full sentence (see the Misuse of Colons section at the bottom of this page for a more detailed explanation)
  2. Use a different style of bullet for bullets that are indented
  3. Start bullet points with capital letters. This improves readability, especially when the bullet point contains a long phrase. Nested bullets that start with lowercase letters are especially difficult.
@daniel-montalvo
Copy link
Collaborator

Thanks for your feedback @KimPatch

Some of these are current EOWG style conventions.

We will consider this for future iteration. We are now working on the Content Author modules

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

No branches or pull requests

2 participants