Re: Updated Nits [Re: Finalizing an Issue-204 CP]

Cynthia Shelly writes:
> I did all except #7, because #7 is a direct quote from another document.
> 
Absolutely. Direct quotes should stay as they are--errors and all.

Thanks, Cynthia.

Janina

> -----Original Message-----
> From: 'Janina Sajka' [mailto:janina@rednote.net] 
> Sent: Tuesday, April 24, 2012 4:25 PM
> To: Cynthia Shelly
> Cc: John Foliot; 'Benjamin Hawkes-Lewis'; 'Laura Carlson'; 'HTML Accessibility Task Force'; 'Joshue O Connor'; 'Judy Brewer'; david100@sympatico.ca; 'Richard Schwerdtfeger'; 'James Nurthen'; 'Leif Halvard Silli'; 'Jonas Sicking'
> Subject: Updated Nits [Re: Finalizing an Issue-204 CP]
> 
> This updates my previous list at:
> http://lists.w3.org/Archives/Public/public-html-a11y/2012Apr/0163.html
> 
> Use this list instead.
> 
> 				--Janina
> 
> 
> 1.)	 The word 'visibility' is mispelled in the first paragraph of
> Summary. Offending sentence begins:
> "They can already do this with CSS display:none and visisbility:hidden, ..."
> 
> 
> 2.)	In the summary you say:
> 	"... so this change will correct the hidden attribute
> 	section so it is in
> 	   accord with the ARIA specification and ARIA functionality."
> 
> 	   	It's a stylistic nit, and I'm not about to fall on any
> 		sword, but might you rather have:
> 
> "... so this change will correct the hidden attribute section to bring it into conformance with the ARIA ..."
> 
> 
> 3.)	The indefinite article is missing from a sentence in the
> explanatory text below Example 2 in the Rationale section. The offending sentence currently reads:
> "For visual users, the text box followed by a looking glass icon is well-known visual pattern for a search function."
> 
> 	Add an 'a' ahead of "well-known" so that it reads "... icon is a
> 	well-known visual ..."
> 
> 	Also, the commas in this paragraph are not needed.
> 
> 4.)	I see four nits in the explanatory paragraph below Example 3.
> 
> 	a.)	The explanatory text begins: "This example shows a variation of Example 3"
> 		Do you actually mean "of Example 2" ? As in "a variation
> 		of the former example?"
> 	b.)	The word 'accessibility' is mispelled in the thred
> 	sentence, currently "... via the accessibiltiy API, ..."
> 
> 		c.)	Further in that same paragraph there's a
> 		grammatical number disagreement where the text currently
> 		reads:
> 		"Since the screen-reader user does not use a mouse, and
> 		does not trigger the mouseover, he gets an experience
> 		that works for him, and the sighted users gets one that
> 		works for her."
> 
> 	Should say 'user' (singular) to match 'her' (singular.
> 
> 	d.)	The last three words of this paragraph, "... and not
> 	all." are, imo superfluous. I suggest this would read better
> 	without them.
> 
> 5.)	There's a repeated sentence--the same sentence ends the
> paragraph following #4 above, and begins the one immediately above "Feedback from Browser Implementers." This repeated sentence reads:
> "Because authors rarely run their content through conformance checkers, authors are likely to point at @hidden content from aria-describedby and aria-labelledby whether or not we forbid them from doing so."
> 
> 	I believe you want to drop the first instance and keep the
> 	second.
> 
> 
> 6.)	There's a missing 'i' in the word 'addition' immediately below
> the Maciej citation, "In addtion ..." Or, is this still part of the quote from Maciej, in which case we shouldn't correct the error? I can't tell--unless I go read the Wiki source!
> 
> 
> 7.) Immediately above the quote from UAIG 5.7.2 there are several references to the ARIA Working Group. Strictly speaking, of course, there's no such thing. We have an ARIA Task Force in the PF Working Group.
> 
> 8.)	Missing 'i' in two occurances of 'accessibility' in a para that starts:
> 	"UAIG says that hidden elements are not exposed via the
> 	accessibiltiy API, ..."
> 
> 9.)	A little further down, a missing 'i' in the word "addition," in
> a para that starts:
> "In addtion, UAIG Section 5.5.1. ..."
> 
> 10.)	And still a bit further down, a transposed 'it' in the phrase
> 'accessibility API' in the first enumerated item below a para that starts:
> "When aria-labelledby and aria-describedby reference an element that IS NOT hidden, ..."
> 
> 11.)	Mispelled "implementation" in the last sentence of the paragraph
> that begins:
> "Name calculation is what is at issue in this CP."
> 
> 
> 12.)	In Details, in the first "Add" section, the paragraph
> immediately above the one that begins:
> "CAPTION: , and <figcaption>. This technique should not be used ..."
> appears to end with a comma, and not a full stop.
> 
> 	We want a period there.
> 
> 
> 13.)	In the "Risks" section, a missing 's' in the word "existing" and a missing
> comma (or perhaps better a long dash) immediately before that word? The sentence in question reads:
> 
> "There have not been many reports of problems with this the exsiting <label> and aria-labelledby functionality with CSS display:none and visibility:hidden, ..."
> 
> Janina
> 
> -- 
> 
> Janina Sajka,	Phone:	+1.443.300.2200
> 		sip:janina@asterisk.rednote.net
> 
> Chair, Open Accessibility	janina@a11y.org	
> Linux Foundation		http://a11y.org
> 
> Chair, Protocols & Formats
> Web Accessibility Initiative	http://www.w3.org/wai/pf
> World Wide Web Consortium (W3C)
> 
> 
> 
> 
> 
> 

-- 

Janina Sajka,	Phone:	+1.443.300.2200
		sip:janina@asterisk.rednote.net

Chair, Open Accessibility	janina@a11y.org	
Linux Foundation		http://a11y.org

Chair, Protocols & Formats
Web Accessibility Initiative	http://www.w3.org/wai/pf
World Wide Web Consortium (W3C)

Received on Wednesday, 25 April 2012 05:10:09 UTC