W3C home > Mailing lists > Public > public-wai-ert-tsdtf@w3.org > October 2007

Re: HTML view of metadata: please comment

From: Shadi Abou-Zahra <shadi@w3.org>
Date: Tue, 16 Oct 2007 10:35:45 +0200
Message-ID: <471477E1.60409@w3.org>
To: Christophe Strobbe <christophe.strobbe@esat.kuleuven.be>
CC: TSDTF <public-wai-ert-tsdtf@w3.org>
Hi Christophe,

Thanks for starting this, I think it is very useful to have an HTML 
"visualization" of the XML code. As usual, I have a lot of comments ;) 
-I've made many of the changes directly and attached the new file. Here 
is what I did for your consideration:

#1. Removed *Sample* from the <h1> and added the status label (in this 
case "unconfirmed") so that no one misses it.

#2. Added an "Applies To" entry to the metadata table, and put the link 
to the WCAG 2.0 Success Criterion directly in there (I think this data 
can be easily decoded from the ID).

#3. Added a "Review History" entry to the metadata table, from which the 
link to the status link should start -the "Status" entry now also 
contains the expanded text of the status level (for more clarity), and a 
link back to the Review Process (for transparency).

#4. Changed "Date" to "Last Updated" but still think it is ambiguous (is 
it the last updated date of this HTML view or of the test sample?).

#5. Changed "Sample Files" section to "Test Files", and put the link to 
the XML matadata in there too -these are the files that are needed to 
execute the test automatically, and now all in one place.


#6. Added an "Expected Results" section beneath the "Test Case", and 
also put here the link to the technique/failure. See my question too.

#7. The section "Technologies and Features" needs to be easier to read. 
For example, the "Note:"-prefix of the first sentence is not necessary, 
it is actually a very helpful sentence. In fact, consider expanding this 
explanation as not many people will know what is mean by "Technologies 
and Features". The rest of the contents in this section are on-liners 
and it is not easy to understand the relationship between them. Is it a 
hierarchy? Consider using lists, tables, or other structures to better 
highlight how these different bits of information relate.


Hope this helps!

Regards,
   Shadi


Christophe Strobbe wrote:
> Hi,
> 
> I have been working on XSLT that generates an HTML view of our metadata. 
> In the HMTL file, you can find the output for one of our test samples. 
> The XSLT still needs some more work, but I would like to get your 
> feedback on the current presentation before I continue.
> We will also discuss this in tomorrow's teleconference.
> 
> Best regards,
> 
> Christophe
> 
> 

-- 
Shadi Abou-Zahra     Web Accessibility Specialist for Europe |
Chair & Staff Contact for the Evaluation and Repair Tools WG |
World Wide Web Consortium (W3C)           http://www.w3.org/ |
Web Accessibility Initiative (WAI),   http://www.w3.org/WAI/ |
WAI-TIES Project,                http://www.w3.org/WAI/TIES/ |
Evaluation and Repair Tools WG,    http://www.w3.org/WAI/ER/ |
2004, Route des Lucioles - 06560,  Sophia-Antipolis - France |
Voice: +33(0)4 92 38 50 64          Fax: +33(0)4 92 38 78 22 |


Received on Tuesday, 16 October 2007 08:36:03 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:06:01 UTC