Visitar URL original
Editorial: updates to intro sections by daniel-montalvo · Pull Request #2958 · w3c/aria · GitHub
Skip to content

Editorial: updates to intro sections - #2958

Open
daniel-montalvo wants to merge 14 commits into
mainfrom
editorial-updates-to-intro-sections
Open

Editorial: updates to intro sections#2958
daniel-montalvo wants to merge 14 commits into
mainfrom
editorial-updates-to-intro-sections

Conversation

@daniel-montalvo

@daniel-montalvo daniel-montalvo commented Nov 2, 2026 •
edited by github-actions Bot
Loading

Copy link
Copy Markdown
Contributor

🚀 Netlify Preview:
🔄 this PR updates the following specs:

As a new policy within WAI to have intro, abstract, and status of this document reviewed by @tamsinewing555 -- just putting her suggestions in this PR plus a couple other things.

  • Typos in image text for the contract model -- I don't currently have the band with / skills to fix that, so I am proposing to just leave it as-is or have somebody else take a stab at it
  • Title case versus sentence case -- The new W3C guide style (proposed) suggests using sentence case for titles. @tamsinewing555 Do you think that's mature enough of an advice for us to change our titles?

@daniel-montalvo daniel-montalvo self-assigned this Nov 2, 2026
@netlify

netlify Bot commented Nov 2, 2026 •
edited
Loading

Copy link
Copy Markdown

✅ Deploy Preview for wai-aria ready!

Name Link
🔨 Latest commit 59af0d4
🔍 Latest deploy log https://app.netlify.com/projects/wai-aria/deploys/6aeba6ab6ae3c7d3ea936c17
😎 Deploy Preview https://deploy-preview-2958--wai-aria.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

@daniel-montalvo daniel-montalvo added the editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo label Nov 2, 2026
@github-actions

github-actions Bot commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

🚀 Deployed on https://deploy-preview-2958--wai-aria.netlify.app

@github-actions
github-actions Bot temporarily deployed to pull request November 2, 2026 19:06 Inactive
@tamsinewing555

tamsinewing555 commented Nov 2, 2026

Copy link
Copy Markdown

Title case versus sentence case -- The new W3C guide style (proposed) suggests using sentence case for titles. @tamsinewing555 Do you think that's mature enough of an advice for us to change our titles?

@daniel-montalvo - yes, we've been gradually updating headings to sentence case for some time now, with Comm's approval. The W3C Style Guide is now the recommended editorial standard for W3C work. Although it's still in beta, we're encouraging authors and editors to start following its guidance while we continue refining it based on feedback from everyday use and external review.
We welcome feedback on any gaps, inconsistencies, or areas that need clarification through GitHub issues until 29 January, 2027.

@tamsinewing555

tamsinewing555 commented Nov 3, 2026

Copy link
Copy Markdown

@daniel-montalvo - I committed a suggested revision of that tricky section, building on your changes, in the same branch: #2959

I'll complete the rest of the review next, which should be much more straight forward.

@pkra pkra added this to ARIA Editors Nov 3, 2026
@github-project-automation github-project-automation Bot moved this to Agenda+ in ARIA Editors Nov 3, 2026
@daniel-montalvo daniel-montalvo mentioned this pull request Nov 3, 2026
Open
2 tasks
@github-actions
github-actions Bot temporarily deployed to pull request November 3, 2026 16:22 Inactive
tamsinewing555
tamsinewing555 reviewed Nov 4, 2026
View reviewed changes
Comment thread index.html Resolved
tamsinewing555
tamsinewing555 reviewed Nov 4, 2026
View reviewed changes
Comment thread index.html Resolved
tamsinewing555
tamsinewing555 reviewed Nov 4, 2026
View reviewed changes
Comment thread index.html Resolved
tamsinewing555
tamsinewing555 reviewed Nov 4, 2026
View reviewed changes

@tamsinewing555 tamsinewing555 left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@daniel-montalvo - I checked all your changes against the document we worked in and you've caught them all, bar one (unless that was deliberate?).
Meticulous work!
I also spotted a wandering comma :)

@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 02:55 Inactive
@tamsinewing555

tamsinewing555 commented Nov 4, 2026

Copy link
Copy Markdown

Just noting here for future review, when time allows, that the new W3C Style Guide recommends:

@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 18:44 Inactive
@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 18:47 Inactive
@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 18:50 Inactive
daniel-montalvo and others added 7 commits November 4, 2026 19:50
@daniel-montalvo
First batch of editorial changes
5106daa
@daniel-montalvo
More editorial corrections
59dbcfa
@daniel-montalvo
sentence case for titles
368133c
@tamsinewing555
Clarify Figure 1 description, caption, and alternative text
5459d77 
@daniel-montalvo - You mentioned that the editors are open to suggestions for improving the description of Figure 1.  
I've also suggested distinguishing the caption from the alt text.
@daniel-montalvo @tamsinewing555
Correct sentence order
863a3e3 
Co-authored-by: Tamsin Ewing <92897469+tamsinewing555@users.noreply.github.com>
@daniel-montalvo @tamsinewing555
comma
628e124 
Co-authored-by: Tamsin Ewing <92897469+tamsinewing555@users.noreply.github.com>
@daniel-montalvo @tamsinewing555
Update index.html
58e3733 
remove comma

Co-authored-by: Tamsin Ewing <92897469+tamsinewing555@users.noreply.github.com>
@daniel-montalvo
daniel-montalvo force-pushed the editorial-updates-to-intro-sections branch from f1bbad5 to 58e3733 Compare November 4, 2026 18:50
@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 18:52 Inactive
giacomo-petri
giacomo-petri reviewed Nov 4, 2026
View reviewed changes
Comment thread index.html Resolved
@pkra pkra moved this from Agenda+ to Todo in ARIA Editors Nov 4, 2026
jnurthen
jnurthen requested changes Nov 4, 2026
View reviewed changes

@jnurthen jnurthen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @daniel-montalvo and @tamsinewing555, this reads better throughout, and the sentence-case conversion is clean.

A few changes in comments inline - some might already be covered in #2959 - if they are feel free to not take the suggestions

Comment thread index.html Resolved
Comment thread index.html Resolved
Comment thread index.html Resolved
Comment thread index.html Resolved
Comment thread index.html Resolved
Comment thread index.html Resolved
tamsinewing555 and others added 7 commits November 5, 2026 10:37
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
c2e6e7b 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
ac54455 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
177ff23 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
1acb133 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
7eab204 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @jnurthen
Apply suggestion by @jnurthen
21e97bc 
Co-authored-by: James Nurthen <jnurthen@users.noreply.github.com>
@tamsinewing555 @giacomo-petri
Apply suggestion by @jnurthen
59af0d4 
Co-authored-by: Giacomo Petri <giacomo.petri@usablenet.com>
@github-actions
github-actions Bot temporarily deployed to pull request November 4, 2026 21:43 Inactive

This branch was previously deployed

1 inactive deployment
pull request — 59af0d4d Deployed Nov 4, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@tamsinewing555 tamsinewing555 tamsinewing555 left review comments
@giacomo-petri giacomo-petri giacomo-petri left review comments
@jnurthen jnurthen jnurthen requested changes

Requested changes must be addressed to merge this pull request.

Assignees

@daniel-montalvo daniel-montalvo

Labels

editorial a change to an example, note, spelling, grammar, or is related to publishing or the repo spec:aria

Projects

ARIA Editors
Status: Todo

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

4 participants

@daniel-montalvo @tamsinewing555 @jnurthen @giacomo-petri