Terms are words or phrases that act as labels for formally defined concepts. "MRI" is a medical term. ; "Habeas corpus" is a legal term..; and so on. 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, innovates or standardizes, they need a terminology as a tool for themselves, and a corresponding glossary (one of their work products) that helps them communicate about their work. Usually, the group will seek to use terms that have already defined in specifications, standards, dictionaries, or glossaries that already exist. However, they will also typically need to define an additional set terms specific to their group. Several TOIP working groups (WGs) and task forces (TFs) have already expressed this need.

One of the objectives of the ToIP Concepts and Terminology Working Group (CTWG) is to provide ToIP WGs and TFs with:

• A cheap and easy way to define and curate the terms they need as a group, with minimal setup and learning curve.

...

• The ability to formally release

...

• versioned glossaries that show how terms are related,

...

• provide attribution to

...

• sources, and cross-reference terms to increase comprehension and accessibility of the group's work. Glossaries will include terms that the group needs, both terms defined by the group itself, or elsewhere.

To meet this need, the CTWG is introducing terms wikis. Terms wikis are simple GitHub-based 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 meets meet the "easy and cheap" criteria , but allows while allowing 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 a community of interest or a community of practice that  (a terms community) that needs precise alignment about its mental models and the words that describe them (a terminology). 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 ToIP, a terms community typically corresponds to a Working Group or a Task Force. However our goal is for terms wiki tooling to be usable by groups outside of ToIP who also wish to join our overall terminology community. In some cases a single terms community might have several subgroups or projects which each need their own terminology and thus their own terms wikis. That's fine too.

Whenever a terminology is internally cohesive and managed by a crisply delineated set of stakeholders, we call the context in which it lives a scope. Each Every scope needs a glossary that lists the set of terms pertinent to that scope (i.e. its terminology), as well as its own terms wiki that contains the definitions of the terms that are specific to this scope. The following diagram illustrates the relationship between terms wikis and glossaries based on them.

Image Added

How to use

...

a terms wiki

1. Contact the CTWG on slack at #concepts-and-terminology-wg to get Create a terms wiki for your group
2. (Nicky's suggestion: workflow))
3. . (If your group is not within TOIP, that's fine; see these instructions instead.)
4. Understand how your terms wiki is structured.
5. Add a new term and its definition by clicking the green "New Page" button, editing content in markdown, and clicking the green "Save Changes" button when done.
6. Edit a term or its definition by browsing to its page and clicking the green "Edit" button. (Again, "Save Changes" when done).
7. Learn about how to work with hyperlinks.
8. Ask the CTWG on slack at #concepts-and-terminology-wg to help you setup an export of your data to a glossary.How to start a new glossary wiki for your glossary community. <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERS
9. Understanding the template for a glossary wiki page. <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERS
10. How to insert links into glossary wiki pages (or any document you write). <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERSHow your glossary wiki works with the CTWG ToIP Term tool. <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERS
11. <insert additional glossary wiki documentation pages here>

Directory of Glossary Wikis Maintained Directly by the CTWG

1. ctwg-terms is the CTWG's own glossary wiki, i.e., for the terms we use to describe "the terminology of terminology".
2. toip-general-terms is the glossary wiki for terms in general use across the whole of the ToIP community writ large.

Directory of Other Glossary Wikis

Listings are alphabetical order.

Anchor
registry registry

Registry of Terms Wikis and Glossaries

The CTWG doesn't control terms wikis; any community is welcome to create one. However, we do attempt to track them, as a general service to the ToIP community and the public. If you have a terms wiki to add, please let us know. Here are terms wikis (and glossaries) of which we are currently aware:

Why A Wiki?

This definition of a wiki is from the best know known 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 terminology wiki is simply a wiki whose scope is a specific set of terms defined by a specific glossary community that, taken together, form in which a set of terms is being defined by a specific (project of a) community of interest or a community of practice (scope), for its own purposes. This terminology will typically be made available through a glossary for that community.

Why GitHub Wikis?

...

1. GitHub is the standard back-end repository system used by Linux Foundation projects (of which the ToIP Foundation is one).
2. GitHub has a built-in wiki capability called using  GitHub wikis that can be turned on for any GitHub repo.
3. A GitHub repo—and its inherent access control capabilities—provides a standard, widely accessible open source tool for each glossary community to manage its own glossary wiki.
4. A GitHub wiki is stored in Markdown documents in GitHub just like all other GitHub documentation and can be accessed and managed programmatically via the GitHub APIs.
5. The CTWG is developing tooling, called the ToIP Term toolTerminology Engine—that will be able to automatically ingest the contents of glossary wikis that follow the CTWG glossary the CTWG terms wiki guidelines into a shared terminology corpus. This is where the CTWG and the participating glossary communities can add value by mapping terms and concepts across different glossary communities in order to increase the overall communication value of the terms to everyone.

...