Background

The system is fairly large, and maintained/developed by an internationally distributed and highly heterogenerous, diverse and volatile development team.

Stimulus: Users referr to the documentation to understand technical details or troubleshoot issues.

Artifact: Technical Documentation

Response: The documentation provides coherent and intelligible explanations and instructions.

Response Measure (aka metrics):

• At least 90% of the system-specific terms used in the documentation are defined in a glossary section accessible within the same document or via direct links.
• The readability score of the documentation, as measured by the Flesch-Kincaid Readability Test, should be between 60 to 70, which corresponds to a 8th to 9th-grade reading level, ensuring it is easily understandable by the average dev-team member.