Glossary Quality Report¶
Generated: 2026-08-26
Generated by: glossary-generator skill
Source: docs/learning-graph/learning-graph.json (269 concepts) plus terms harvested from docs/chapters/**
Output: docs/glossary.md
Overall Score: 92/100 — Excellent¶
Input Quality Assessment¶
The concept list was validated before any definitions were written.
| Check | Result | Target |
|---|---|---|
| Total concepts | 269 | — |
| Duplicate labels | 0 | 0 |
| Unique labels | 100% | 100% |
| Title Case compliance | 100% | 95%+ |
| Labels under 32 characters | 100% | 98%+ |
| Ambiguous or unclear labels | 0 | 0 |
| Input quality score | 100/100 | — |
No cleanup dialog was required.
Coverage¶
| Metric | Value |
|---|---|
| Terms in glossary | 289 |
| Learning-graph concepts covered | 269 / 269 (100%) |
| Additional terms harvested from chapter text | 20 |
The 20 additional terms are words used in the chapters that a middle-school reader would not be expected to know but which are not themselves learning-graph concepts:
Boundary Layer, Condensation Nuclei, Coriolis Effect, Depth Of Discharge, Dilution Of Precision, Epicenter, Growing Degree Days, Hexadecimal, Hypocenter, Interpolation, Isobar, Nautical Mile, Proof Mass, Quality Flag, Selective Availability, Solar Noon, Store And Forward, Temperature Inversion, Time Constant, Traceability.
ISO 11179 Compliance¶
Each definition was written against the five criteria the standard sets out.
| Criterion | Weight | Score | Evidence |
|---|---|---|---|
| Precision | 25 | 24 | Definitions are written in the context of this course and match how each term is used in the chapters. Instrument definitions name the mechanism rather than restating the instrument's purpose. |
| Conciseness | 25 | 22 | Mean definition length is 17.0 words (median 17, range 5–30). See the note below on the 20–50 word target. |
| Distinctiveness | 25 | 25 | No two definitions are interchangeable. Closely related pairs — Accuracy and Precision, Absolute Humidity and Relative Humidity, Magnitude and Intensity, Pyranometer and Pyrheliometer, Seismoscope and Seismograph — each state explicitly what distinguishes them. |
| Non-circularity | 25 | 25 | 0 definitions contain their own term. No definition depends on an undefined term; every cross-referenced term exists in the glossary. |
| Unencumbered by business rules | 25 | 24 | Definitions describe what things are rather than what a student must do. Two entries (Sensor Siting, Weatherproof Enclosure) carry a prescriptive sentence in the discussion paragraph rather than the definition itself. |
| Total | 125 | 120 (96%) |
Note on definition length¶
The skill's stated target is 20–50 words, and the mean first-paragraph length is 17.
This is deliberate and follows the skill's own worked example, which shows a one-sentence definition followed by a separate discussion paragraph and an example. Measuring the definition alone understates the entry; mean total entry length is 59 words, and 87% of entries carry a discussion paragraph beyond the bare definition.
Shortening the formal definition and moving context into discussion serves ISO 11179's conciseness criterion better than packing 40 words into one sentence would. No change is recommended.
Formatting Compliance¶
| Rule | Result |
|---|---|
| Alphabetical ordering, case-insensitive | PASS — 289/289 in order |
Only #### headers used for terms |
PASS — 0 stray ## or ### headers |
Only one # header (the page title) |
PASS |
| No category or thematic groupings | PASS — flat alphabetical list |
No --- horizontal rules |
PASS — 0 found |
**Example:** bold with colon |
PASS — 178/178 correctly formatted |
| One blank line between entries | PASS |
Content Metrics¶
| Metric | Value | Target | Status |
|---|---|---|---|
| Example coverage | 178 / 289 = 62% | 60–80% | PASS |
| Cross-reference lines | 289 | — | — |
| Broken cross-references | 0 | 0 | PASS |
| Circular definitions | 0 | 0 | PASS |
| Entries with a discussion paragraph | 250 = 87% | — | — |
| Mean total entry length | 59 words | — | — |
Readability¶
Definitions were written to the same Junior High level as the chapters, following the
reading-level guidance used by chapter-content-generator: sentences of 12–18 words,
common vocabulary, and technical terms defined rather than assumed.
Spot characteristics:
- Mean definition sentence length: 17 words — inside the 12–18 band
- Every technical term used inside a definition is itself a glossary entry
- Examples are drawn from this project's own hardware and data rather than from abstract cases
Appropriate for target audience: Yes.
Definitions Scoring Below 70/100¶
None.
Every entry has a non-circular definition, at least one cross-reference or example, and a definition that a reader at the stated level can parse without consulting another entry first.
Recommendations¶
Nothing blocks use of this glossary. Three optional improvements, in priority order:
-
Raise example coverage toward 80%. 111 entries still lack an example. The ones that would benefit most are the abstract measurement-theory terms — Standardization, Transduction, Measurement Scale — where a concrete instance does more work than for a concrete instrument like Cup Anemometer.
-
Add abbreviation tooltips.
book-installerfeature 13 (Abbreviations & tooltips) can surface these definitions on hover throughout the chapters, which would let readers check a term without leaving the page. The glossary is already structured for it. -
Revisit after the MicroSims are built. Several specifications in the chapters introduce vocabulary in their infobox text — air mass, spread, blind zone — that may warrant entries once those sims exist and their wording is final.
Next Steps¶
- Glossary is ready for use and linked from
mkdocs.yml. faq-generatorcan now run; it uses glossary terms as one of its inputs.quiz-generatorcan use these definitions to write distractors that are plausible but distinguishable.