W3C home > Mailing lists > Public > w3c-wai-gl@w3.org > October to December 1998

Readability of the guidelines

From: Jason White <jasonw@ariel.ucs.unimelb.EDU.AU>
Date: Wed, 18 Nov 1998 18:19:57 +1100 (AEDT)
To: WAI Markup Guidelines <w3c-wai-gl@w3.org>
Message-ID: <Pine.SUN.3.95.981118180148.10676A-100000@ariel.ucs.unimelb.EDU.AU>
I think the guidelines need to be edited for style, grammar and
readability. Cumbersome phrases such as occur in guideline B1 ("navigation
information and [...] presentations of information") should be avoided.
Suitable synonyms could be substituted for words such as "information"
provided that the meaning remains clear in the given context. Expressions
such as "making useful to all users" strike me as stylistically
objectionable: one could say "accessible", "intelligible", "convenient",
"navigable", "understandable", etc., with an appropriate term in each
context.

I am sure that, once the substantive issues have been finalised, the
editors will turn their rigorous intellectual skills to questions of
grammar and style, but it would be irresponsible of me at this stage not
to mention these aspects of the guidelines, which are integral to
effective communication. I think that style and vocabulary are significant
issues in the current draft. Technical terminology has been used
appropriately, but a more liberal choice of synonyms and careful attention
to expression would improve the text immeasurably.
Received on Wednesday, 18 November 1998 02:20:03 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:46:58 GMT