- From: Shadi Abou-Zahra <shadi@w3.org>
- Date: Fri, 29 Aug 2014 11:35:37 +0200
- To: Kevin White <kevin@w3.org>, EOWG <w3c-wai-eo@w3.org>
- CC: Shawn Henry <shawn@w3.org>
Hi Shawn, Thanks for this suggestion. Kevin and I discussed it, and he will be exploring how easy it would be to rewrite the document that way. The main concern is that items are often inter-related and difficult to explain separately. I've added it to the agenda for more discussion. Thanks, Shadi On 29.8.2014 06:14, Shawn Henry wrote: > Kevin & Shadi, > [SNIP] > > When EOWG looked at the organization originally with the key actions > bullet-ed out, I think there was a lot more text in the draft. (I don't > know how to look at earlier versions in github and won't take the time > to figure it out now.) Now there is a less text -- which I support for > this version. However, the result is lots of repetition. The intro > paragraph is generally an abbreviated version of the key actions, and > then the More detail just adds a few more sentences and examples. > > A more significant issue: I found that when I read the key actions, > sometimes I wasn't sure what one meant, and then when I went to the More > detail section, it was not easy to find the additional explanation for a > specific key action. So sometimes I would read a key action, and want to > understand it better before I read the others, so I'd skip down to try > to find it in the More details, but I had to skim around to find where > it was covered because it wasn't easy to find and sometimes it was in a > paragraph with other information, and then I went back to the key > actions -- or later I didn't want to do that so I kept reading the key > actions with the question in the back of my mind, and then when I got to > the More detail, I was looking for the info related to my question and > so I didn't really give enough attention to the other info, so I had to > go back and re-read it. So overall the flow was annoying unfortunately. > > Just an idea: I wonder if it might work well for reading flow, for > skim-ability, for information chucking, etc. to change the organization > so the key actions phrases are ex-col headings with the details right > under each? > > Happy to discuss... > > ~Shawn -- Shadi Abou-Zahra - http://www.w3.org/People/shadi/ Activity Lead, W3C/WAI International Program Office Evaluation and Repair Tools Working Group (ERT WG) Research and Development Working Group (RDWG)
Received on Friday, 29 August 2014 09:36:11 UTC