Rename Terminology to Glossary in the docs

[heartsucker]

Description

This is the expected term, and we should make a reference to the glossary early in each of the respective sections like

• Source Guide
• Journalist Guide
• Admin Guide
• Install SecureDrop

User Research Evidence

While a UX team was looking at the docs, they asked "why isn't there a glossary" since they couldn't find it.

[bumbleblue]

I would want to add that a glossary/terminology section would also make terminology across website and documentation more consistent. Once you decide on the words to use, there can be a sprint to find&replace some of the confusing terms 🙂

[bumbleblue]

Example: What's a SD workstation? vs. a journalist interface? what constitutes secure viewing?

[ninavizz]

^ I love the idea of a documentation sprint; we're currently doing lots of mini/adhoc efforts, and currently @zenmonkeykstop and (I think?) @huertanix are co-leading the first major overhaul of the Source guide. This is a great bit for them to consider (poke, poke!—renaming "terminology" to "glossary;" goal being prioritizing clarity and resonance among a wider swath of users, versus the linguistic precision that creates cognitive dissonance... cuz humans gonna be humans, and not perfect).

There is an open issue in the sd-ux repo to unite nomenclature across the entire product, as informed by findings from the Workstation project. That said: it's critically important this does NOT fall off the priorities radar... and I appreciate this issue, so much, for reinforcing that urgency. Thank you, Eileen!!

P.S.: @bumbleblue if you ever feel inspired to attend a crit at 17:00UTC we'd love to have your voice and thoughts! https://github.com/freedomofpress/securedrop-ux/wiki/Meetings

[huertanix]

@ninavizz I'm down for a doc sprint!

[ninavizz]

Pokey pokey @eloquence you mentioned in standup today you'd be doing some work in RTD? 😸

[lbeaufort]

Hi there! I'd like to work on this issue.