Releases: gemmology-dev/gemmology-knowledge
v1.4.1
v1.4.0
130 learn YAML files updated across all content categories.
- Em-dashes converted to commas, semicolons, or parentheses throughout
- Filler adjectives (e.g. "crucial", "essential", "paramount") and transition adverbs (e.g. "Moreover", "Furthermore", "Additionally") trimmed where used as padding
- Numeric ranges, technical hyphens, and citation markers are unchanged
- Schema unchanged; all 138 YAML files pass validation
v1.2.0 — Citation infrastructure
Citation infrastructure across all 138 learn articles
This release adds structured citations to the entire FGA learn corpus, replacing freeform prose author-year citations with schema-validated reference entries and inline {cite:id} markers.
What changed
- 138 articles across 8 categories now carry top-level
references:blocks following a CSL-JSON-inspired schema (kind,authors,title,year, DOI/ISBN/URL). - 623 inline
{cite:id}markers placed in sections, callouts, items, table captions, and subsections. - Reference kinds restricted to:
book | journal | web | standard. - Backlink-friendly: every cite marker pairs with a bibliography entry at the article footer.
Coverage by category
| Category | Articles | Claims annotated |
|---|---|---|
| Fundamentals | 9 | 47 |
| Equipment | 13 | 52 |
| Species | 20 | 147 |
| Identification | 15 | 60 |
| Phenomena | 16 | 46 |
| Origin (top-level) | 15 | 75 |
| Origin (sub-countries) | 45 | 135 |
| Market + Care | 5 | 61 |
Top cited sources
- Read (2014) — Gemmology (3rd ed.). DOI 10.4324/9780080507224
- Hughes (2017) — Ruby & Sapphire: A Gemologist's Guide. ISBN 978-0-9645097-6-4
- Palke et al. (2019) — Origin trilogy in Gems & Gemology
- Nassau (2001) — The Physics and Chemistry of Color
- Gübelin & Koivula — Photoatlas of Inclusions in Gemstones v1 & v2
- Schumann (2009) — Gemstones of the World
Verification
- Schema validation (
validate:citations): 0 errors, 45 unused-reference warnings (non-blocking, follow-up cleanup). - Astro content collection build: 913 pages compile cleanly.
- Per-category audit reports retained at
gemmology.dev/.tmp/citation-audit-*.mdfor traceability.
Downstream
gemmology.dev consumes this content via scripts/sync-knowledge.ts. A follow-up commit on that repository pins the sync to tag v1.2.0 and surfaces the version in the site footer.
Schema-conformance fixes folded in
v1.1.1 — British English compliance and AI-tell removal
Style sweep — no content change
This release contains a style-only language sweep across the FGA learn content. No information, schema, or structure has changed; only how prose is displayed.
Changes
- Em-dashes: 742 → 26 across 84 YAML files. The 26 remaining instances are
"—"null-cell markers in tables (crystal-systems.yaml,other-tools.yaml) and are intentional. All prose em-dashes have been replaced with the Oxford spaced en-dash–or, where two clauses can stand alone, with full stops, semicolons, colons, or parentheses. - AmE → BrE:
traveling→travellinginfundamentals/optical-properties.yaml. Citation titles, journal names, author names, mineral species, and chemical formulas were preserved verbatim regardless of spelling. - AI-tell phrases removed: three "in today's [X] market" phrasings recast in
species/pearl.yaml,origin/burma/ruby.yaml, andorigin/east-africa/tsavorite.yaml.
Verification
- All YAML files parse cleanly.
biss-languages:british-grammarvalidation pass on the diff.- Zero AmE prose remaining in non-citation strings; zero AI-tell phrases.
Downstream
gemmology.dev picks up this content via npm run sync on its next build. No code change required on the website side.
Merged PRs
- #3 — style(lang): British English compliance and AI-tell removal across learn content
v1.1.0 — FGA Foundation + Diploma coverage gap-fill
What's new
Closes ~70 distinct content gaps from the May 2026 Gem-A FGA syllabus audit. Foundation coverage 72% → ~100%; Diploma coverage 47% → ≥80%.
Added
- Equipment (5): chelsea-colour-filter, sg-measurement, conoscope, advanced-lab-instruments, diamond-screening; spectroscope.yaml gains 27-spectra reference table.
- Fundamentals (3): colour-theory (CFT, charge transfer, colour centres), twin-laws, optic-sign-determination; expansions to crystal-systems and physical-properties.
- Phenomena (7): schiller, silk-effect, fluorescence, fire-dispersion, orient, tenebrescence, alexandrite-effect.
- Treatments-deep: Be diffusion, lead-glass ruby, HPHT diamond, CVD diamond.
- Origin (28 files, 11 regions): Thailand, Cambodia, Vietnam, Pakistan, Afghanistan, Tajikistan, India, Iran, Russia, USA, Mozambique, Zimbabwe, Ethiopia, Colombia mines, Brazil additional.
Pipeline
research-synthesist (10 agents, 4 waves) → citation-verifier (218 claims reviewed) → builders (file-locked scopes). Source priority: Gem-A → peer-reviewed → Webster/Read 7th ed. → Mindat.
Validation
Astro npm run build: 791 pages (was 697; +94). All YAMLs pass closed Zod schema.