Appendix G - Standards & Specifications
Core standards for consistent work products
Learning Objectives
- Apply naming/file standards consistently
- Count LOC correctly for metrics
- Use PSP defect taxonomy
- Follow interface and message conventions
Overview
Appendix G defines the standards that keep TSPi artifacts consistent and measurable.
Naming & Files
- Hierarchy: system → product → component → module → object.
- File naming: consistent prefixes/suffixes; avoid spaces; use lower/upper per team rule.
- Variable/parameter naming: descriptive, standard casing; avoid abbreviations.
LOC Counting
Use agreed LOC counting rules for metrics; include/exclude comments/blank lines per standard; ensure consistent tool support.
Defect Types (PSP Standard)
| Type | Examples |
|---|---|
| Documentation | Comments, headers |
| Syntax | Typos, grammar, punctuation |
| Build/Package | Linking, dependency |
| Interface | Calls, parameter mismatches |
| Checking | Validation, error handling |
| Data | Structures, values, initialization |
| Function | Logic, requirements mismatch |
| System | Configuration, environment |
| Assignment | Work item misunderstanding |
Interfaces & Messages
- Parameter roles (in/out/error) documented and consistent.
- Error/messages: consistent format, codes, and wording.
- Reuse interface conventions across components to reduce errors.