Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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, 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. The Usually, the group will typically seek to use terms that are have already defined earlier, e.g. in a standardin specifications, standards, dictionaries, or glossaries that already exist. However, they will also typically need a to define an additional set of terms that are specific to the group, which they then need to define themselvestheir group. Several TOIP working groups (WGs) and task forces (TFs) have already expressed this need.

One of the objectives of CTWG is to provide TOIP WGs /and TFs with:

  • a cheap A cheap and easy way to define and curate the terms they need as a group, with minimal setup and learning curve.
  • the The ability to formally release and version glossaries, a way to see versioned glossaries that show how terms are related, a way provide attribution to attribute sources, a way to reference terms from other places...and cross-reference terms to increase comprehension and accessibility of the group's work.

To meet the first need, the CTWG is introducing terms wikis (the second need, for generating rich glossariesWe introduce terms wikis to start all this (the second more nifty part in which e.g. glossaries are generated, will follow later). Terms wikis are simple websites that allow collaborative editing in a browser. They meet the "easy and cheap" criteria , and allow 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 community of interest or a community of practice that needs precise alignment about its mental models and the words that describe them (a terminology). In TOIP, these groups typically correspond to WGs or TFs. Sometimes one group undertakes multiple projects, and each is worthy of its own terminologyHowever our terms wiki tooling can also be used by groups outside of ToIP that wish to join our overall terminology community. Sometimes a single group needs to undertake multiple projects where each requires its own terminology. 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 its own terms wiki.

How to use

...

a terms wiki

  1. Contact the CTWG on slack at #concepts-and-terminology-wg to get a terms wiki for your group. (If your group is not within TOIP, that's fine; see these instructions instead.)
  2. Understand how your terms wiki is structured.
  3. 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.
  4. Edit a term or its definition by browsing to its page and clicking the green "Edit" button. (Again, "Save Changes" when done).
  5. Learn about how to work with hyperlinks.
  6. Ask the CTWG on slack at #concepts-and-terminology-wg to help you setup an export of your data to a glossary.
  7. Understanding the template for a glossary wiki page. <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERS
  8. How your glossary wiki works with the CTWG ToIP Term tool. <== THIS PAGE TO BE DEVELOPED BY CTWG VOLUNTEERS
  9. <insert additional glossary wiki documentation pages here>

...