Skip to content

Add example section for visual markup explanation to G96#5073

Open
CharlesBelov wants to merge 2 commits into
w3c:mainfrom
CharlesBelov:patch-1
Open

Add example section for visual markup explanation to G96#5073
CharlesBelov wants to merge 2 commits into
w3c:mainfrom
CharlesBelov:patch-1

Conversation

@CharlesBelov

Copy link
Copy Markdown

Added a text-specific example section explaining visual markup with semantic meaning.

Added an example section explaining visual markup with semantic meaning.
@netlify

netlify Bot commented Apr 16, 2026

Copy link
Copy Markdown

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit a940a87
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/69f1443a484e7c0008176390
😎 Deploy Preview https://deploy-preview-5073--wcag2.netlify.app
📱 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.

@patrickhlauke patrickhlauke changed the title Add example section for visual markup explanation Add example section for visual markup explanation to G96 Apr 16, 2026
@github-project-automation github-project-automation Bot moved this to To do in WCAG 2.x Apr 16, 2026
@patrickhlauke patrickhlauke moved this from To do to Drafted in WCAG 2.x Apr 16, 2026
@w3cbot

w3cbot commented Apr 16, 2026

Copy link
Copy Markdown

patrickhlauke marked as non substantive for IPR from ash-nazg.

</section>
<section class="example">
<h3>Visual markup with semantic meaning has explicit text explaining the meaning</h3>
<p>A redline document designates deleted text with strikethrough and added text with double underline. Deletions are preceded by the text "[begin deletion]" and followed by the text "[end deletion]. Additions are preceded by the text "[begin addition]" and followed by the text "[end addition].</p>

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.

shouldn't additions/deletions use <ins> and <del> ? or are you concerned about whether or not AT currently announce/expose these?

@CharlesBelov CharlesBelov May 5, 2026

Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

@patrickhlauke I do have concerns about whether <ins> and <del> are read by screen readers, an area I don't have expertise in, but the main issue is with publishing the document to the web as a PDF, which my understanding is that WCAG covers.

If I use track changes in Word to track insertions and deletions, when it is saved as PDF, the deleted text is removed as is the markup that there has been an addition. There doesn't appear to be any option in Word to Save to PDF with the tracked changes intact.

If I print, the tracked changes are there. But printing to PDF does not produce accessibility tags.

In the case of my agency, the San Francisco Municipal Transportation Agency, we don't use track changes to create these PDF files. Instead, we apply strikethrough to deleted content and a particular font and underscores to inserted text.

There is the further complication that additions and deletions can - admittedly rarely - be done by both the SFMTA Board and by the Board of Supervisors of the City and County of San Francisco. In such cases, we have two different deletion styles and two different insertion styles, something which <ins> and <del> can't handle semantically.

None of this markup makes it from Word to PDF tags when saving as PDF. Our only available workaround is to explicitly show the additions and deletions as verbiage in a conforming alternative document.

@patrickhlauke patrickhlauke moved this from Drafted to In progress in WCAG 2.x May 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: In progress

Development

Successfully merging this pull request may close these issues.

3 participants