I hope I put this question in the right place.
Currently, I am working on a huge software project. Within this project, we use a lot of different terms, words and verbs. We want to write down all terms with an explanation of what we actually mean with it. Also, we want to write down when to use which word.
For example, we have the term "challenge" with it's explanation. Whenever you are going to create a new challenge, the button should say "Create challenge". When you are in the form, the button to actually save it should be named "publish".
I am wondering if anyone has some sort of guidelines or an example of how to write the terms with it's explanation down and all rules related to the use of words.
I could of course create a glossary, but where to put all the rules then? Should it be 2 separate documents? Should I put the rules next to each word?
Looking forward to what you all are thinking. Thanks in advance!