Skip to content

Change 'serialize' to 'linearize' in Note 2 of Consistent Help - #5119

Open
bruce-usab wants to merge 5 commits into
mainfrom
wcag2ict-3_2_6-editiorial
Open

Change 'serialize' to 'linearize' in Note 2 of Consistent Help#5119
bruce-usab wants to merge 5 commits into
mainfrom
wcag2ict-3_2_6-editiorial

Conversation

@bruce-usab

@bruce-usab bruce-usab commented May 14, 2026

Copy link
Copy Markdown
Contributor

Change serialize to linearize in Note 2 of SC 3.2.6 Consistent Help.

Use of the incorrect word caused some confusion on WCAG2ICT call today, see minutes.

(FWIW, since I looked it up, this sort of error is a catachresis. [Edited to use Wiktionary rather than Google.])

Change serialize to linearize in Note 2 of SC 3.2.6 Consistent Help
@github-project-automation github-project-automation Bot moved this to To do in WCAG 2.x May 14, 2026
@bruce-usab bruce-usab moved this from To do to Drafted in WCAG 2.x May 14, 2026
@netlify

netlify Bot commented May 14, 2026

Copy link
Copy Markdown

Deploy Preview for wcag2 ready!

Name Link
🔨 Latest commit 402e3b5
🔍 Latest deploy log https://app.netlify.com/projects/wcag2/deploys/6a414b93d10fb200089e2498
😎 Deploy Preview https://deploy-preview-5119--wcag2.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.

@bruce-usab bruce-usab added the ErratumRaised Potential erratum for a Recommendation label May 14, 2026
@bruce-usab

Copy link
Copy Markdown
Contributor Author

For this success criterion, ”the same order relative to other page content” can be thought of as how the content is ordered when the page is serialized linearized.

@bruce-usab
bruce-usab requested a review from GreggVan May 14, 2026 16:01
@patrickhlauke

Copy link
Copy Markdown
Member

i believe in computing the terms are often used interchangeably though - serialisation in computing is about breaking down complex data structures into simpler forms that can be transmitted (like converting a complex structure into JSON is referred to as "serialisation" to convert the complex structure into a string)

@patrickhlauke patrickhlauke changed the title Correct typo in Note 2 of Consistent Help Change 'serialize' to 'linearize' in Note 2 of Consistent Help Jun 7, 2026
@bruce-usab

Copy link
Copy Markdown
Contributor Author

i believe in computing the terms are often used interchangeably…

Fair point, but for a lay person, serialized raises the idea that the page is meant to be broken into a series of pages. Which is almost a coherent idea; enough so to trip someone up. Regardless, linearized is closer to plain language.

@patrickhlauke patrickhlauke moved this from Drafted to Ready for approval in WCAG 2.x Jun 12, 2026
@patrickhlauke patrickhlauke moved this from Ready for approval to Sent for WG approval in WCAG 2.x Jun 15, 2026
@awkawk

awkawk commented Jun 15, 2026

Copy link
Copy Markdown
Member

I stand by serialize as the correct term here. In the Understanding document we wrote: "If the help item is visually in a different location, but in the same serial order, that is not helpful from a user's point of view, but it would not fail this criterion."

If the point is to make this clearer to lay people it should be clarified in Understanding, it is correct in the main document.

@patrickhlauke

Copy link
Copy Markdown
Member

@dbjorge mentioned in our call that "serialize" has a very specific and different meaning to what's intended here, even for technical people (indeed, serialization is about converting into a format that can be transmitted and then later reconstructed)

@GreggVan

Copy link
Copy Markdown

Having read all this -- I think linearize is the best term. Serial has both the serial data AND the serial as in broken up into pieces/episodes/installments aspects. Linearize does not

@patrickhlauke patrickhlauke moved this from Sent for WG approval to Errata for refresh in WCAG 2.x Jun 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3.2.6 Consistent Help ErratumRaised Potential erratum for a Recommendation

Projects

Status: Errata

Development

Successfully merging this pull request may close these issues.

4 participants