Skip to content

Conversation

@mehrazmorshed
Copy link
Contributor

@mehrazmorshed mehrazmorshed commented Sep 11, 2025

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).

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).
@mcking65 mcking65 changed the title Keeping consistency in numbering Carousel Pattern: Fix inconsistency in use of digits and number words Sep 16, 2025
@css-meeting-bot
Copy link
Member

The ARIA Authoring Practices (APG) Task Force just discussed PR 3362: Carousel Pattern: Fix inconsistency in use of digits and number words by mehrazmorshed.

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

Copy link
Contributor

@daniel-montalvo daniel-montalvo left a 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.

Copy link
Contributor

@mcking65 mcking65 left a 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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

4 participants