Versions Compared

Key

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

...

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. However 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. Every scope needs 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.

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>

...