Comments on TAG draft 0.6

[Lynne Rosenthal <lynne.rosenthal@nist.gov>]

Suggested changes to the Introduction

1st paragraph:
This document is a guide to test assertions. Its purpose is to help 
the reader understand what test assertions are, the benefits of test 
assertions, and most importantly, how to create them. As you will 
discover, test assertions can be an important and useful tool in 
promoting quality of specifications, test suites and implementations 
of the specification. You will learn that there are multiple ways to 
create test assertions.  However, by following the guidance in this 
document, the likelihood is increased of developing well-defined test 
assertions that can have many useful purposes and applications (for 
example, as the starting point for a conformance test suite for a 
specification).  Experiences in developing test assertions will be 
shared, along with lessons learned, helpful tricks and tools, hazards 
to avoid, and other tidbits of knowledge that may be helpful in 
crafting test assertions.

Organization of the document section:
In Section 1, the rationale for test assertions is presented; 
followed by Section 2 which describes basic design principles.  In 
Section 3, advanced features related to test assertions will be 
given. In Section 4, a summary is presented, and in Section 5 a 
glossary of important terms is given. Appendices provide revision 
history, references, and a listing of prior art.

The document is structured to accommodate different levels of 
interest. Those interested in obtaining a basic understanding of test 
assertions Sections 1 and 2 will be of interest. Developers and users 
of test assertions who encounter more complex situations and 
challenges to writing or using test assertions, should read Section 3.

--Lynne