janeway icon indicating copy to clipboard operation
janeway copied to clipboard

Consider Roman numeral use

Open StephDriver opened this issue 9 months ago • 2 comments

Roman numerals are difficult to make accessible, such that the general advice on how to do so, boils down to don't. This was noted during screen reader testing (#4194).

  • Sample 3, item 16. first section heading is correctly an H2, but the I. Roman numeral denoting it as the first section does not get read out as "one" but "I" get later for section 2, the "II." is read out as 2. This is a problem with the screenreader not being able to distinguish for single 'I' that it is a roman numeral. Similar issues are known with other single letter Roman numerals. See notes.
  • Sample 3, item 36. use of Roman Numerals within the text (not just as headings) to denote a list within the paragraph, for example: It might refer (i) to actual results, i.e., to the empirical impact—if that can be measured—that each lie actually has on the enterprise of human communication. Or (ii) it might refer and so on. The initial (i) is read as i and then the (ii) as 2 - see notes on Roman numerals.
  • Sample Other, item 11. Roman numerals are not just a screen reader A11y issue. There doesn't seem to be an accepted solution, with general advice being to limit their use. WC3 guidance is to avoid the use of Roman Numerals and unfamiliar symbols in text where possible.

We need to consider how to handle Roman Numerals. We could simply ban them from the platform, but I suspect it would be more acceptable to users for us to allow them in specific use-cases and have very specific ways to use them for those with work arounds to make that as accessible as possible, for example, section numbering and list numbering. Note this is not just a screen-reader issue, but roman numerals for numbering can be difficult across multiple types of impairment.

StephDriver avatar May 31 '24 11:05 StephDriver