-
Notifications
You must be signed in to change notification settings - Fork 421
Carousel Pattern: Fix inconsistency in use of digits and number words #3362
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
Conversation
In one place, found using slide one (word form), in another slide 2 (digit). Best to keep consistent (preferably digits in technical writing: slide 1, slide 2).
|
The ARIA Authoring Practices (APG) Task Force just discussed The full IRC log of that discussion<jugglinmike> Topic: PR 3362: Carousel Pattern: Fix inconsistency in use of digits and number words by mehrazmorshed<jugglinmike> github: https://github.com//pull/3362 <jugglinmike> Matt_King: This was an issue raised by someone outside of the Task Force <jugglinmike> Matt_King: It's a simple pull request. I was about to approve it, but I wanted to ask this group a question <jugglinmike> Matt_King: In the text that's being changed, we have some places where the word "two" (t-w-o) was used, and other place where the number "2" was used <jugglinmike> Matt_King: This person made the change so that in all cases in this text, we're using the digits instead of the spelled-out words. My gut would have been to go in the other direction (that is: to change the digits to words), but since in this particular case, we're talking about using the numbers as identifiers, then it seems consistent with style guidelines <jugglinmike> Jem: I support that <jugglinmike> Matt_King: There's also a W3C editorial practice, which at one time was aligned with the Chicago Manual of Style. Typically, we say that most of the time, yo u spell out number. But again, because we're using the numbers as identifiers (rather than as numbers), this case seems different <jugglinmike> Daniel: When I was an editor, I knew more than I do, now. It seems reasonable, but I'll take a look <jugglinmike> Matt_King: Do you mind being designated as a formal reviewer? <jugglinmike> Daniel: Sure. This is not slated for the September milestone, right? <jugglinmike> Matt_King: That's correct; it is not. You can take your time <jugglinmike> Matt_King: Keep in mind that it's just a one-liner, though <jugglinmike> [general discussion about a regression in the accessible user experience of the "patch review" user-interface of GitHub.com] <jugglinmike> Jem: I've assigned Daniel as a reviewer |
daniel-montalvo
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The relevant line that I could find under our Resoure style guide is:
Use words for numbers that start a sentence, and for numbers up to one hundred (guidance based on documents where descriptive or narrative text is predominant and numbers are not the significant focus)
Agree that these numbers are not the significant focus.
mcking65
left a comment
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thank you @mehrazmorshed for your contribution to APG content quality!
In one place, found using slide one (word form), in another slide 2 (digit).
Best to keep consistent (preferably digits in technical writing: slide 1, slide 2).
WAI Preview Link (Last built on Thu, 11 Sep 2025 08:34:14 GMT).