[libreoffice-l10n] Proposal: Glossary's Terminology Guidelines

Glossary are helpful because there are terms which could cause mistranslations, such as BASIC and 
Calc functions in sbasic and scalc, however there aren't rules to creating a glossary, which could 
cause warnings such as

> DO NOT USE THE “TERMINOLOGY” CHECKBOX UNLESS IT’S REALLY WARRANTED!
>
> PLEASE DON’T CROSS YOUR TEAM’S BOUNDARIES AND ADD GLOSSARY STRINGS ONLY TO YOUR OWN GLOSSARY, NOT 
> TO EVERYONE ELSE’S, UNLESS STRICTLY NECESSARY
> https://translations.documentfoundation.org/translate/libo_ui-master/glossary/en/?checksum=fa4ca0895bb6cde7

Docs for Glossary: https://docs.weblate.org/en/latest/user/glossary.html

- Untranslatable terms: Use this for brand names or other terms that should not be changed in other 
languages
- Forbidden translations: Use this to clarify translation when some words are ambiguous or could 
have unexpected meanings
- Terminology: Use this for important terms that should be well-thought-out, and retain a 
consistent meaning across all languages

Would like to propose guidelines for creating Terminology terms:

SHOULD: What should be in Terminology

- Code variables/functions such as BASIC and Python terms should be Untranslatable terms + 
Terminology
- Excel/Calc functions

SHOULDN'T: What should not be in Terminology

- Adjectives, prepositions, articles, verbs, and non-concrete nouns (common words in general)

Up to discussion:

- Should we use for LibreOffice UI elements/labels/menu such as layout, emphasis, home...?
- While Markdown, Python, Wiki are brand names, translations software such as DeepL and 
Google/LibreTranslate generally don't translate them, thus adding a glossary is unnecessary

If proposal accepted: add key points in https://wiki.documentfoundation.org/Translating_LibreOffice

Antonio Vidal (NamelessGO)
-- 
To unsubscribe e-mail to: l10n+unsubscribe@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/l10n/
Privacy Policy: https://www.documentfoundation.org/privacy