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

Improve readability of Understanding 2.5.8 - target size minimum text #3699

Merged
merged 9 commits into from Apr 2, 2024

Conversation

MrFirthy
Copy link
Contributor

@MrFirthy MrFirthy commented Feb 19, 2024

Closes #3473

The aim of this PR is to adjust the wording and formatting of the understanding page for 2.5.8. I've tried to introduce more simplified, self-contained sentences in order to improve the readability and flow of the page. This includes:

  • Introducing more punctuation for natural breaks
  • Removing some repetition of information to reduce the length of sentences; and
  • Introducing unordered lists for blocks of text that discuss more than two different examples.

Based on online tests, this has improved the readability of the document.

@MrFirthy MrFirthy force-pushed the Issue3473-understanding-wording branch from dd699f1 to 471ee60 Compare February 19, 2024 16:29
Co-authored-by: Patrick H. Lauke <redux@splintered.co.uk>
@mbgower mbgower self-assigned this Feb 23, 2024
understanding/22/target-size-minimum.html Outdated Show resolved Hide resolved
understanding/22/target-size-minimum.html Outdated Show resolved Hide resolved
understanding/22/target-size-minimum.html Outdated Show resolved Hide resolved
@MrFirthy MrFirthy requested a review from dbjorge March 11, 2024 15:07
MrFirthy and others added 3 commits March 21, 2024 11:15
Co-authored-by: Hidde de Vries <160571138+hidde-logius@users.noreply.github.com>
Co-authored-by: DJ Chase <u9000@posteo.mx>
@w3c w3c deleted a comment from scottaohara Mar 22, 2024
@w3c w3c deleted a comment from bruce-usab Mar 22, 2024
@mbgower mbgower merged commit 3505d32 into main Apr 2, 2024
1 check passed
@mbgower mbgower deleted the Issue3473-understanding-wording branch April 2, 2024 19:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

The target spacing (minimum) Understanding document has room for improvements
7 participants