W3C home > Mailing lists > Public > w3c-wai-eo@w3.org > July to September 2005

review comments format

From: Shawn Henry <shawn@w3.org>
Date: Tue, 09 Aug 2005 17:32:25 -0500
Message-ID: <42F92EF9.3090305@w3.org>
To: "EOWG (E-mail)" <w3c-wai-eo@w3.org>

EOWG,

When commenting on documents, it is helpful if you include the following for each of your comments:
* priority[1]
* location
* text you are commenting on
* suggested revision
* rationale

For example:

1. simple wording change 
* priority: [suggested]
* location: business case overview, "Developing a Customized Business Case" section (http://www.w3.org/WAI/EO/Drafts/bcase/Overview.html#custom), first paragraph, first sentence
* current wording: "An effective business case focuses on the organization's objectives and motivations."
* suggested revision: ...on the organization's cats and dogs.
* rationale: the phrase "objectives and motivations" could be difficult for non-native-English speakers to understand, and difficult to translate. "cats and dogs" gets across the same point and is more clear & simple wording.

2. next point summary...

[1] This will vary according to the stage of the document. 
For documents that are in final review and approval stages, it is helpful to use [required this version] or [suggested] to indicate if it is an issue that you feel must be addressed before this version is posted, or if it is a suggestion for "editor's discretion" and can be held for consideration for the next version.

Regards,
~ Shawn
Received on Tuesday, 9 August 2005 22:32:28 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 20:29:38 UTC