W3C home > Mailing lists > Public > w3c-wai-gl@w3.org > January to March 2003

Re: 4.1 latest version

From: Avi Arditti <aardit@voa.gov>
Date: Fri, 31 Jan 2003 15:05:36 -0500
Message-ID: <3E3AD710.5E6E8C28@voa.gov>
To: Roberto Scano - IWA/HWG <rscano@iwa-italy.org>
CC: "W3c-Wai-Gl@W3.Org (E-mail)" <w3c-wai-gl@w3.org>, Maurizio Boscarol <maurizio@usabile.it>, Lisa Seeman <seeman@netvision.net.il>

The irony! You're right -- I should explain ...

How about:

2) A controlled language is used (Controlled languages are designed to
make documents easier to understand and translate. They are based on
natural language, but use a restricted vocabulary and avoid complex
syntax. Controlled language standards generally limit words to a single
meaning and prescribe their use by part of speech. Much information
about controlled languages is available on the World Wide Web.)
   

Roberto Scano - IWA/HWG wrote:
> 
> Hi Avi!
> 
> At level 3:
> 
> "2. A controlled language is used"
> 
> "controlled language", IMHO, must be explained well... what you wanna say
> with "controlled language" ?
> 
> ----- Original Message -----
> From: "Avi Arditti" <aardit@voa.gov>
> To: "W3c-Wai-Gl@W3.Org (E-mail)" <w3c-wai-gl@w3.org>
> Cc: "Maurizio Boscarol" <maurizio@usabile.it>; "Lisa Seeman"
> <seeman@netvision.net.il>
> Sent: Thursday, January 30, 2003 8:39 PM
> Subject: Re: 4.1 latest version
> 
> Oops, forgot to note that the "length and complexity of sentences" item
> at the Minimum Level now includes Maurizio's guidance on the need to
> vary sentence lengths.
> 
> Avi Arditti wrote:
> >
> > Updates to reflect suggestions thus far: now refers to "cohesion" of
> > paragraphs in Minimum Level, adds "coherence of pronouns" as an item at
> > Level 2, and moves "summaries" to Level 2)
> >
> > ---
> >
> > This checkpoint lists ideas to help you review content for clarity. Many
> > of these ideas are promoted within the global movement for plain
> > language. The items below are not presented as success criteria,
> > however, nor as any attempt to impose a particular editorial style.
> > Rather, they are elements to consider as you review writing. They
> > reflect the idea that accessibility begins with understanding.
> >
> > You meet Checkpoint 4.1 at the Minimum Level if you review the content
> > with items such as these in mind:
> >
> > 1) Familiarity of terms and language structure
> > 2) Length and complexity of sentences (guides to clear writing advise
> > writers to vary sentence lengths within a document, but to keep
> > sentences short where possible and limited to one idea)
> > 3) Cohesiveness of paragraphs (paragraphs that are limited to a single
> > idea and a reasonable length are generally easier to understand)
> > 4) Clarity of headings and linked text when read out of context.
> > 5) Accuracy and uniqueness of page titles
> >
> > You meet Checkpoint 4.1 at Level 2 if you review the content with items
> > such as these in mind:
> >
> > 1) Use of sentence structures that increase understanding (such as
> > active voice in those languages where it is considered desirable for
> > conveying information)
> > 2) Length of noun phrases (strings of no more than three or four nouns
> > are easiest to understand)
> > 3) Coherence of pronouns
> > 4) Complexity of verb tenses (simpler tenses are easier to understand)
> > 5) Intelligibility of verb phrases
> > 6) Familiarity of idioms or slang
> > 7) Logic in the order and flow of information
> > 8) Consequences of ambiguity or abstraction
> > 9) Desirability of vertical lists in place of long paragraphs of
> > information
> > 10) Use of summaries to aid understanding.
> > 11) Thoroughness in the explanation of instructions or required actions
> > 12) Consistency in the use of names and labels
> > 13) Clarity where the document:
> > -  addresses users
> > - explains choices and options
> > - labels options to get more information
> > - instructs how to modify selections in critical functions (such as how
> > to delete an item from a shopping cart)
> > 14) Usage of:
> > - proper markup to highlight key information
> > - goal-action structure for menu prompts
> > - default settings (and the ease in re-establishing them)
> > - two-step "select and confirm" processes to reduce accidental
> > - selections for critical functions
> > - calculation assistance to reduce the need to calculate
> >
> > You meet Checkpoint 4.1 at Level 3 if at least one of the following is
> > true:
> >
> > 1. New material is tested with potential users for ease of
> > accessibility
> > 2. A controlled language is used
> > 3. Support is given for conversion into symbolic languages
Received on Friday, 31 January 2003 15:06:22 GMT

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