Just finished reading SpecGL (cover to cover). Thank you Karl and Dom for
putting so much of your time into getting this together and published.
Since we advocate doing a quality review of the document, I hope its not
too late to make some of these changes typos, awkward English, missing
words, etc.
1. Goals and Motiviation: 1st sentence
s/specifications precise/specifications that are precise/
2. About this document
replace principles with requirements in The overall objective of these
principles and good practices is to facilitate
3. About this document paragraph, If in a hurry. This doesn't really make
sense, since everyone regardless of if you are in a hurry, will start with
the first section. Propose rewrite
If in a hurry just read the first section, Specifying conformance this
may be all you need to read in order to reach the expected outcome of
adhering to this document, i.e., specifying conformance.
4. Structure of this document. Last paragraph
s/wish/wishes/
s/has to follow the conformance section/must satisfy the conformance
requirements in the conformance section/
s/the principles as normative/the requirements as normative/
5. 1. Specifying conformance, 1st para, last sentence
s/types/type/
6. 1.1 A conformance clause is essential, 1st sentence
s/sanctioned by the/sanctioned by/
7. Is the heading for 1.1B there? I'm working off line from the version
Dom sent yesterday
8 1.2 Specify how to make conformance claims
s/proactive:/proactive./ (substitute a period for the semi-colon)
9. 2.3A Why care, 2nd para
s/implications for the conformance/implications for conformance/
10. 2.3A Techniques #2
s/on the/in your/
11. 2.3B What does it mean
s/precision, use/precision, and use/
12. 3.2A Techniques 3rd bullet
s/style use/style uses/
s/defaults/weaknesses/ (defaults is the wrong word)
13. 4 Managing Variability, 2nd para
s/advices/advice/
14 4.1B Technique #3
s/dependent other/dependent upon other/
15. 4.3A Address Extensibility (is the 4.3A Requirement there?, its not
on my copy)
Technique #4
Remove /principles and/ -- there are only GP in the rest of this section
16. 4.3B What does it mean
s/help ensure/helps to ensure/