Post History
Some thoughts: I would ask the users instead of guessing whether they use the in-page popups. Do a (small) survey. Some users may not use the glossary because they are unaware of it but would if ...
Answer
#3: Attribution notice added
by
System
·
2019-12-08T07:00:00Z (almost 5 years ago)
Source: https://writers.stackexchange.com/a/30174 License name: CC BY-SA 3.0 License URL: https://creativecommons.org/licenses/by-sa/3.0/
#2: Initial revision
by
System
·
2019-12-08T07:00:00Z (almost 5 years ago)
Some thoughts: - I would ask the users instead of guessing whether they use the in-page popups. Do a (small) survey. - Some users may not use the glossary because they are unaware of it but would if they knew. Ask in the survey. - While I don't often use a glossary, the one time that I do it is usually indispensable. - If you dispense with the glossary, make sure that all terms that are not easily found on the web are defined somewhere in the text of your documentation. Context may not explain them all equally well. - A glossary might serve as a guideline for the writers (!) on how to use certain terms. If you don't have one, each writer might use a term differently.
#1: Imported from external source
by
System
·
2017-09-11T07:51:11Z (about 7 years ago)
Original score: 6