How to Create Terms Wikis (including outside TOIP)

Owned by Daniel Hardman
Last updated: Jun 29, 2022
1 min read

(These instructions are also covered in an instructional video on YouTube...)

  1. You need someone in your org with rights to create github repos.
  2. Create a (probably public) github repo. Name it something like <your-group-abbrev>-terms. Whatever you choose for <your-group-abbrev> will become a tag that applies to all terms in the repo/wiki.
  3. Turn on the github repo's wiki feature. (Settings > Options > Features; tick Wikis)
  4. Turn off most of the other features; you won't need them. (Settings > Options > Features; untick other stuff)
  5. Configure permissions and/or contributors. (Settings > Manage access)
  6. Add at least one term to your wiki. (Wiki > New Page; copy the template from here and fill it out.)
  7. Share the URL of the repo's wiki (NOT the URL of the repo itself, but <repo> + /wiki; THIS is where you want people to go to use the wiki).
  8. Consider registering your wiki with the CTWG so the world can discover it (see "Registry of Terms Wikis" here).
  9. Configure your repo to publish a glossary.

Note: a Term Wiki is a place where you can develop the terminology that is specific to the needs you have for serving some purpose(s). The wiki should not serve as a glossary; glossaries are to be generated from wiki content.