The shareable glossaries project is developing standards, tools and processes to help establish interoperable glossaries between organizations and projects.
Glossaries are easy to set up for simple examples but very hard to scale - especially when you try to scale across use cases, across domains and across different organizations.
Unfortunately, in 2022, the world is yet to:
We aim to change this by breaking down technical barriers, raising awareness of solutions, and supporting widespread adoption of shareable glossaries.
As projects and their teams grow, documentation becomes increasingly important to enable clear communication. At the same time, it becomes harder to maintain unambiguous terminology due to competing source material and team priorities.
While there are mature standards and supporting tools for publishing and maintaining controlled vocabularies, there is currently a high technical barrier to learning these - something we hope to help simplify.
More details in the modeling primer.
Viral uptake of shareable glossaries depends upon the realization of two key use cases:
Refer to glossary use cases for more use cases and more details.
A glossary should start small, with minimal metadata fields. As the glossary matures, more metadata fields can be added to address advanced use cases.
|0 No glossary|
|1 Non-shareable||Help a reader understand locally defined terms.|
|2 Machine readable||Enables tooling, like domain specific hover-over popups.|
|3 Traced to source||Know which glossaries terms come from.|
|4 Governed||Manage glossary maintenance.|
|5 Extra metadata||Support power use cases.|
More details at shareable glossary maturity levels.
Some may think it optimistic to nudge the world toward adopting shareable glossaries. We believe it is achievable, within a few years, by: breaking the problem into solvable components, and collaborating with domain experts for each part of the problem.
These components include: