[SpecGL Draft] B. GP Write simple direct statements in the scope

Good Practice: Write simple, direct statements in the scope.

What does this mean?
When writing the scope, be direct and write simple, understandable 
statements of facts.  Don’t include any requirements in the scope section.

Why care?
This one of the first sections a reader reads, so it is important to 
capture their attention and make sure they understand what the 
specification is about.

Techniques:
Use statements such as: This document
    * specifies a method of …
    * specifies the characteristics of …
    * defines …
    * establishes s system for …
    * establishes general principles for …
    * is a guide for …

Examples:
 From CC/PP 
<http://www.w3.org/TR/2004/REC-CCPP-struct-vocab-20040115/#ScopeOfDocument>http://www.w3.org/TR/2004/REC-CCPP-struct-vocab-20040115/#ScopeOfDocument 
“CC/PP Structure and Vocabularies …defines a client profile data format, 
and a framework for incorporating application- and operating 
environment-specific features.”


--Lynne 

Received on Wednesday, 11 August 2004 12:38:43 UTC