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

Format for QAF principles

From: Lynne Rosenthal <lynne.rosenthal@nist.gov>
Date: Wed, 03 Mar 2004 03:51:36 -0500
Message-Id: <>
To: www-qa-wg@w3.org

To get us started and to help provide consistency as we write the 
principles, here is a proposed format that we can follow.  Realize that all 
the items may not apply or be necessary for each and every principle.   I 
wasn't able to find Karl's QAF to FAQ to ensure that I captured his ideas - 
but I think I have.

Storyboard (story, situation)
Preconditions or assumptions

Benefit of applying principle

Examples, more examples
Template and/or tool to implement
[good practices]
[constraints  exemptions, caveats]

Assessment: Have I got it right  how do I know

At a minimum:  we should always have the Principle, description, examples.

Words to remember:
Acknowledging that giving advice is easy and implementing it is hard, we 
need to:
- try to find the balance between too much documentation, complexity and 
- remember that stating the obvious is not always obvious

Received on Wednesday, 3 March 2004 03:52:32 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:14:32 UTC