Skip to content

Clear Language July 2025 #341

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

Open
wants to merge 7 commits into
base: main
Choose a base branch
from
Open

Conversation

kfranqueiro
Copy link
Contributor

@kfranqueiro kfranqueiro commented Jul 14, 2025

This replaces the "Clear meaning" and "Simplified written content" guidelines in the document with a "Clear language" guideline.

Overlap Notes (Attention: Editors)

  • This PR adds "Topic sentence" under "Clear language"; it is now removed from under Structure in Organization and Structure Jun 2025 #336
  • 3 requirements in this PR overlap with the Supplemental Content guideline (under Help), and could supersede those requirements; TBD whether they remain under this guideline or move there (cc @rachaelbradley)
    • Numerical supplements
    • Unambiguous numerical formatting
    • Visual aids
  • There is also strong correlation between Clear language and multiple requirements currently listed under Structure; we should pay attention to whether these all make it to Developing status for the next WD:
    • Section labels
    • Section length
    • Section purpose
    • White spacing
  • There are currently 2 requirements listed in this PR that this subgroup was considering removing, and deferring to the Structure requirements above. We have left them in, in case editors want to review the overlap. Further information on the overlap is available in the pathway document.
    • Clear structure
    • Short blocks of text
  • It may be worth thinking through the current ordering and structure of the overall document to ensure the related items above appear closer together?

@netlify /guidelines/#clear-language

Copy link

netlify bot commented Jul 14, 2025

Deploy Preview for wcag3 ready!

Name Link
🔨 Latest commit 92d7d24
🔍 Latest deploy log https://app.netlify.com/projects/wcag3/deploys/687a3c3ed7c9440008d26621
😎 Deploy Preview https://deploy-preview-341--wcag3.netlify.app/guidelines/#clear-language
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link

netlify bot commented Jul 14, 2025

Deploy Preview for wcag3-howtos canceled.

Name Link
🔨 Latest commit 92d7d24
🔍 Latest deploy log https://app.netlify.com/projects/wcag3-howtos/deploys/687a3c3e842f2400086fbcc0

@kfranqueiro kfranqueiro changed the title Clear Language july 2025 Clear Language July 2025 Jul 14, 2025
@kfranqueiro kfranqueiro force-pushed the group-plain-language-jul-2025 branch from 11e8150 to 5937ad2 Compare July 17, 2025 15:41
@kfranqueiro kfranqueiro force-pushed the group-plain-language-jul-2025 branch from 2bdf0d5 to 21df358 Compare July 17, 2025 19:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants