docs: remove the glossary and its tests #882

New issue

Closed

opened 2026-10-23 04:35:42 +00:00 by hexajon · 0 comments

hexajon commented

2026-10-23 04:35:42 +00:00

Owner

Decision (hexajon, 2026-10-22): remove the glossary and its tests.

Acceptance criteria

docs/GLOSSARY.md is deleted.
internal/docs/glossary_test.go and internal/docs/glossary_coverage_test.go are deleted.
README.md and docs/README.md no longer link the glossary.
No doc links to docs/GLOSSARY.md, so the link test passes.
The gate passes.

The glossary from #452 adds a gate test that fails any doc with an all-caps word that has no glossary row. That test was never part of the #452 decision, which named a glossary page and a link only. It now blocks unrelated doc work, and it polices prose, which is not this project's job. Decision (hexajon, 2026-10-22): remove the glossary and its tests. ## Acceptance criteria - [ ] docs/GLOSSARY.md is deleted. - [ ] internal/docs/glossary_test.go and internal/docs/glossary_coverage_test.go are deleted. - [ ] README.md and docs/README.md no longer link the glossary. - [ ] No doc links to docs/GLOSSARY.md, so the link test passes. - [ ] The gate passes.

hexajon referenced this issue

2026-10-23 04:38:20 +00:00

docs(a11y): provide an abbreviation-expansion mechanism (WCAG 3.1.4) #452

hexajon referenced this issue from a pull request that will close it,

2026-10-23 16:14:56 +00:00

docs: remove the glossary and its tests, and accept the docs-only gate record #885

hexajon closed this issue

2026-10-23 16:14:59 +00:00