Glossary Quality Report
Generated 2026-10-09 by the glossary-generator skill for docs/glossary.md.
- Source:
docs/learning-graph/learning-graph.csv (581 concepts, matching concept-list.md)
- Concept list quality: 581 unique labels, 100% Title Case, 100% under 32 characters (score 100/100)
- Every definition was drafted from the chapter passage that defines the term (
docs/chapters/*/index.md, located through each chapter's "Concepts Covered" table). Where a chapter defines a term, the glossary uses the chapter's meaning.
Coverage and Structure
| Check |
Result |
| Terms in glossary |
581 |
| Concepts covered |
581 of 581 (100%) |
| Duplicate terms |
0 |
| Alphabetical order (case-insensitive) |
100% |
Header levels other than # title and #### terms |
0 |
--- separators |
0 |
mkdocs build --strict |
Pass (glossary not yet in nav: INFO only) |
ISO 11179 Metrics
| Metric |
Result |
| Average definition length |
22.0 words (min 11, max 37) |
| Definitions in the 20-50 word target |
428 of 581 (74%); the rest are 11-19 words |
| Definitions over 50 words |
0 |
| Self-referential definitions (term used in its own definition) |
0 |
| Mutually circular pairs (A defined with B and B with A) |
0 |
| Definitions starting with the term |
0 |
| Example coverage |
78.1% (target 60-80%) |
| Cross-references (See also / Contrast with) |
0 used, so 0 broken |
| Flesch-Kincaid grade of definitions |
about 12 |
Scores
Each definition is scored on four 25-point criteria. Conciseness (by word count), distinctiveness (by word overlap with the most similar other definition) and non-circularity are computed by script. Precision is a manual judgment: each definition was written against its chapter passage and given 25.
| Measure |
Value |
| Overall mean score |
98.2 / 100 |
| Automated criteria only (conciseness, distinctiveness, non-circularity) |
97.6 / 100 |
| Definitions scoring 85-100 |
577 |
| Definitions scoring 70-84 |
4 |
| Definitions below 70 |
0 |
Recommendations
- Parallel sister terms share wording by design and differ only in their distinguishing value: the discharge positions (UBD, TAU, THD, TAD, DBD, BAD, BHD, BAU), Clockwise and Counterclockwise Rotation, Hub on Intake Side and Hub on Discharge Side, the fan-law rules, the ceiling and wall gravity dampers, and the arrangement variants. Review them together.
- Arrangement 2 is defined from the AMCA standard, as Chapter 11 does. FanPedia's arrangement drawings do not include it.
- Construction Class is a term this book coined (Chapter 20) and does not appear as a catalog field.
- Definitions that state requirements ("must") describe what the term means rather than a policy: Application Requirements, Fan Specification, RTO Service Conditions and similar entries.
- Readability is grade 12, which suits the adult technical audience in
course-description.md.