W3C home > Mailing lists > Public > public-comments-wcag20@w3.org > June 2006

[WCAG2] i18n comment: Provide simpler text

From: <ishida@w3.org>
Date: Tue, 27 Jun 2006 18:07:42 +0000
To: public-comments-wcag20@w3.org, public-i18n-core@w3.org
Message-Id: <20060627170742.9C4774F144@homer.w3.org>

Comment from the i18n review of:
http://www.w3.org/TR/2006/WD-WCAG20-20060427/

Comment 1
At http://www.w3.org/International/reviews/0606-wcag2/
Editorial/substantive: E
Owner: RI

Location in reviewed document:
Introduction

Comment: 
The content of the introduction is long and written in a legalistic style that is hard to get through. I think this can putoff, or at least scare, web designers and content authors.


I suggest that you provide short summaries of each major section, written in a friendly style, so that people can get thegist of the section. That way the complex normative text can remain, but does not have to be read in detail until needed.


Also, use more active phrasing. For example, "The set of technologies that an author assumes are supported and turned on inaccessible user agents is called a baseline." could be written "A baseline is what we call the set of technologies that an author assumes aresupported and turned on in accessible user agents." This is easier to read, makes it easier to find the definition of 'baseline', and gives a quickeridea of the content of the paragraph for those who are skimming text.
Received on Tuesday, 27 June 2006 17:07:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Sunday, 17 July 2011 06:13:20 GMT