-
Type: Bug
-
Status: Deferred
-
Priority: Major
-
Resolution: Unresolved
-
Affects Version/s: virtio 1.1 cs01
-
Fix Version/s: None
-
Labels:None
-
Environment:
Style
-
Proposal:
In terms of accessibility, "what follows," "below," and "follows" all inhibit the use of VIRTIO by users assisted by reading software.
Take 2.2 Feature Bits as an example:
"Feature bits are allocated as follows:
0 to 23 Feature bits for the specific device type
24 to 37 Feature bits reserved for extensions to the queue and feature negotiation mechanisms
38 and above Feature bits reserved for future extensions."
A sighted reader is clued in that 3 entries follow, but reading software does not offer, in this form, the same clue.
Compare:
"Feature bits are allocated in three ways:
1. 0 to 23 Feature bits for the specific device type
2. 24 to 37 Feature bits reserved for extensions to the queue and feature negotiation mechanisms
3. 38 and above Feature bits reserved for future extensions."
Same text but now both sighted as well as assisted readers know there are 3 ways to allocate feature bits and each of those ways is numbered and recited to the reader.