How to create a vocabulary

How to create a vocabulary

Fig. 1: Vocabulary build and pull process

1. Select the vocabulary editor of your choice.
2. Create the vocabulary using the SKOS Simple Knowledge Organization System. See also the SKOS Primer for the basics. NOTE: Always first check if there is an international or national vocabulary (see Vocabularies of the World).
   a. Use Vocbench to create the vocabulary.
   b. Use the Excel template to create the vocabulary - download Excel SKOS Vocabulary Builder.
   c. Edit the vocab TTL file in Visual Studio Code. Use the extension Language Support for RDF related language syntax for formatting support.
3. Export the vocabulary to a TTL file. If using Vocbench, it is easier to export the TTL from the Build repository in GraphDB. Follow the instructions here.
4. Validate the TTL file using GSQ's copy of ChekaBox, the validation tool
   • NOTE: ChekaBox will be available in May, 2020
5. Add the TTL file to a new branch of GSQ's Vocabularies repository in Github.
   • Name your branch review-some_name.
   • See how-to instructions here.
6. When you're ready to publish your vocabulary into Test, submit a Pull Request to the GSQ's Vocabularies repository's master branch.
   • See how-to instructions here.
7. A member of the Data Integrity Team will review your vocabulary and either Approve or Request Changes.
   • See how-to instructions here.
8. If the pull request is approved, the vocab will now be public in GSQ's VocPrez server (https://vocabs.gsq.digital/vocabulary/) and your development branch can be deleted.