Terms are words or phrases that act as labels for formally defined concepts. "MRI" is a medical term. "Habeas corpus" is a legal term... Any time a group of experts invents or standarizes, terms and their definitions are an important tool as well as a work product.
We could manage terms in lots of ways – everything from writing them down on post-it notes to putting them in a spreadsheet to recording them in fancy professional terminology databases. Here at TOIP, we want something cheap and easy, with minimal setup and learning curve. Yet we want some fanciness, too – the ability to formally release and version glossaries, a way to see how terms are related, a way to attribute sources, a way to reference terms from other places...
Our answer to this tension is terms wikis. These are simple websites that allow collaborative editing in a browser. They meet the "easy and cheap" criteria, but allows some sophisticated features under the hood. Think Google Docs, but with slightly more structure – or Wikipedia, but a whole lot simpler. You can learn how to use them in 5 minutes.
A terms wiki is owned by a any community of interest or a community of practice that needs precise alignment about its mental models and the words that describe them. In TOIP, these groups typically correspond to working groups or task forces. Sometimes one group undertakes multiple projects, and each is worthy of its own set of terms. Whenever a set of terms is internally cohesive and managed by a crisply delineated set of stakeholders, we call the context in which it lives a scope. Each scope needs its own terms wiki.
The CTWG doesn't control or approve terms wikis. However, we do attempt to track them, as a general service to the public. If you have a terms wiki to add, please let us know. Here are terms wikis (and glossaries) we know about:
Tag and Link | Community | Description | Month Started | Glossary Links |
---|---|---|---|---|
#ctwg | Concepts and Terminology Working Group (CTWG) | Terminology for the CTWG tools, terms wiki design, curation, and our own documentation. | May 2021 | |
#toip-general | the greater TOIP ecosystem | terms used throughout TOIP contexts | May 2021 | |
#essiflab | eSSIF Lab | ? | ? | ? |
#ghp | ToIP Interoperability Working Group for Good Health Pass | Global interoperability of health certificates and travel passes with a focus on COVID-19 | April 2021 | 1.0 |
#sovrin | Sovrin Foundation | Governance and operation of the Sovrin Foundation and Sovrin ledger | January 2017 | 3 |
#yoma-gf | Yoma Governance Framework WG | July 2021 | ||
This definition of a wiki is from the best know wiki in the world, Wikipedia:
A wiki (/ˈwɪki/ (listen) WIK-ee) is a hypertext publication collaboratively edited and managed by its own audience directly using a web browser. A typical wiki contains multiple pages for the subjects or scope of the project and could be either open to the public or limited to use within an organization for maintaining its internal knowledge base.
The basic idea of a glossary wiki is simply a wiki whose scope is a specific set of terms defined by a specific glossary community that, taken together, form a glossary for that community.
There are several reasons the CTWG chose GitHub to host our glossary wiki capability: