W3C home > Mailing lists > Public > www-qa-wg@w3.org > March 2002

Re: Spec Guidelines

From: Daniel Dardailler <danield@w3.org>
Date: Fri, 08 Mar 2002 10:36:28 +0100
Message-Id: <200203080936.g289aS020656@zidane.inria.fr>
To: Martin Duerst <duerst@w3.org>
cc: Dominique Hazael-Massieux <dom@w3.org>, spec-prod@w3.org, www-qa-wg@w3.org

Having a unique document, albeit longer, doesn't preclude us from
generate P1 views, or easy-to-check checklist, out of it.

The advantage would be to 
 - only carries one set of requirements, no duplicate
 - more easily evolve requirements from MAY to SHOULD to MUST (by
   just changing the priority level)
 - the use of a more familiar framework of guidelines/checkpoint that
   will foster the adoption of the less important points (because you
   can claim AA)


> I'm not sure I agree. Pubrules are hard and fast rules;
> if you don't follow them, publication is rejected. It
> should be kept as short as possible.
> 
> The style guide is on a different level. It tries to help
> editors, and contains many things that may be obvious to
> people who are used to technical writing, and many things
> that one could also do another way, and where it is good
> to have some help, but if somebody has good reasons, they
> should be able to do things somewhat differently. The
> style guide is already long, and can get longer.
> 
> Regards,   Martin.
> 
> At 09:56 02/03/01 -0500, Dominique Hazael-Massieux wrote:
> >On Fri, Mar 01, 2002, Daniel Dardailler wrote:
> > > I don't think it's a good idea to have both
> > >   http://www.w3.org/Guide/pubrules
> > > as a subset of
> > >   http://www.w3.org/2001/06/manual/
> > >
> > > This duplication will lead to confusion.
> > >
> > > I think we should only carry forward the second one, the Manual of
> > > Style, using a checkpoint layout with priorities 1, 2, 3 (much like
> > > the WAI guidelines), and assign P1 to pubrules checkpoints, with a
> > > policy enforcing level A.
> >
> >That looks a  very reasonnable proposal. We'll have to think about the
> >process part of such a merge, since pubrules are a quite sensible
> >subject (changes must be approved by the team, announced to the chairs).
> >
> >Dom
> >--
> >Dominique Haza $BuM (B-Massieux - http://www.w3.org/People/Dom/
> >W3C's Webmaster
> >mailto:dom@w3.org
Received on Friday, 8 March 2002 04:36:33 GMT

This archive was generated by hypermail 2.2.0 + w3c-0.30 : Thursday, 9 June 2005 12:13:09 GMT