Change 'serialize' to 'linearize' in Note 2 of Consistent Help - #5119
Change 'serialize' to 'linearize' in Note 2 of Consistent Help#5119bruce-usab wants to merge 5 commits into
Conversation
Change serialize to linearize in Note 2 of SC 3.2.6 Consistent Help
✅ Deploy Preview for wcag2 ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
|
|
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) |
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. |
|
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. |
|
@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) |
|
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 |
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.])