"Innovate! Follow the standard and do it intelligently. That means including what you know needs to be included regardless of what the standard says. It means adding additional levels or organization that make sense."
— IEEE Computer Society,
Software Engineering Standards Collection
For your convenience, we've included in this section all of the IEEE templates (and variations) used in this book. Some templates have been modified based on the experiences of the authors and as described in the text of this book. These changes (additions) are presented in italics. If you delete all of the italicized words in each template, the original IEEE template would remain.
For a complete description of each template, please refer to the corresponding section of the book indicated in the right margin. The complete IEEE guidelines can be purchased from the IEEE Web site at www.ieee.org.
IEEE Std. 829-1998 Standard for Software Test Documentation Template for Test Documents
Used for the master test plan and level-specific test plans.
Test Design Specification
Used at each test level to specify the test set architecture and coverage traces.
Test Case Specification
Used as needed to describe test cases or automated scripts.
Test Procedure Specification
Used to specify the steps for executing a set of test cases.
Used as needed to record the execution of test procedures.
Test Incident Report
Used to describe anomalies that occur during testing or in production. These anomalies may be in the requirements, design, code, documentation, or the test cases themselves. Incidents may later be classified as defects or enhancements.
Test Summary Report
Used to report completion of testing at a level or a major test objective within a level.
Figure C-1: Template for Test Documents from IEEE Std. 829-1998 Refer to Chapter 1 for more information.
IEEE Std. 829-1998 Standard for Software Test Documentation Template for Test Planning
- Test Plan Identifier
- Table of Contents
- Test Items
- Software Risk Issues
- Features to Be Tested
- Features Not to Be Tested
- Item Pass/Fail Criteria
- Suspension Criteria and Resumption Requirements
- Test Deliverables
- Testing Tasks
- Environmental Needs
- Staffing and Training Needs
- Planning Risks and Contingencies
Figure C-2: Template for Test Planning from IEEE Std. 829-1998 Refer to Chapter 3 for more information.
IEEE Std. 1008–1987 for Software Unit Testing
Scope and References
Inside the Scope
Outside the Scope
Unit Testing Activities
Plan the General Approach, Resources, and Schedule
Determine Features to Be Tested
Refine the General Plan
Design the Set of Tests
Implement the Refined Plan and Design
Execute the Test Procedures
Check for Termination
Evaluate the Test Effort and Unit
Figure C-3: Rick's copy of the Unit Testing Standard Refer to Chapter 4 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Design Specification
- Test Design Specification Identifier
- Features to Be Tested
- Approach Refinement
- Test Identification
- Feature Pass/Fail Criteria
Figure C-4: Test Design Specification Template from IEEE Std. 829-1998 Refer to Chapter 5 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Case Specification
- Test Case Specification Identifier
- Test Items
- Input Specifications
- Output Specifications
- Environmental Needs
- Special Procedural Requirements
- Inter-Case Dependencies
Figure C-5: Test Case Specification Template from IEEE Std. 829-1998 Refer to Chapter 5 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Procedure
Test Procedure Specification Identifier
Specify the unique identifier assigned to this test procedure.
Supply a reference to the associated test design specification.
Describe the purpose(s) of the procedure and refer to the test cases being executed.
Describe any special requirements such as environmental needs, skill level, training, etc.
This is the heart of the test procedure. The IEEE describes several steps listed below:
Describe any special methods or formats for logging the results of test execution, the incidents observed, and any other events pertinent to the test.
Describe the sequence of actions necessary to prepare for execution of the procedure.
Describe the actions necessary to begin execution of the procedure.
Describe any actions necessary during execution of the procedure.
Describe how the test measurements will be made.
Describe the action necessary to suspend testing when unscheduled events dictate.
Identify any procedural restart points and describe the action necessary to restart the procedure at each of these points.
Describe the actions necessary to bring execution to an orderly halt.
Describe the action necessary to restore the environment.
Describe the actions necessary to deal with anomalies and other events that may occur during execution.
Figure C-6: Test Procedure Template from IEEE Std. 829-1998 Refer to Chapter 5 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Log
- Test Log Identifier
- Activity and Event Entries
Figure C-7: Test Log Template from IEEE Std. 829-1998 Refer to Chapter 7 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Incident Report
Incident Summary Report Identifier
Date and Time
Attempts to Repeat
Figure C-8: Template for Test Incident Report from IEEE Std. 829-1998 Refer to Chapter 7 for more information.
IEEE Std. 829-1998 for Software Test Documentation Template for Test Summary Report
Test Summary Report Identifier
Summary of Results
Summary of Activities
Figure C-9: Template for Test Summary Report from IEEE-829-1998 Refer to Chapter 7 for more information.
Template for Process Improvement
Test Plan Identifier
Genesis of Process Improvement Initiative
Scope of Initiative
Major Strategy Decisions
What constitutes success? How are progress and results measured?
What should cause us to temporarily suspend our efforts?
Hardware and Software
Staffing and Training Needs
Test Environment Group
Person(s) Approving the Plan
Figure C-10: Test Plan Template MODIFIED for Process Improvement Refer to Chapter 11 for more information.