#95822General glossary for term definitions + workflow for introducing / improving terms
Description
Is it possible to have a centralized glossary in a structured format which can also be synchronized with Crowdin?
How can we proceed with defining new terms and improving terms?
We have glossaries already, (see below), difficulty is to have a central glossary, who maintains it, who decides about terms when new things are introduced (or old terms are improved).
Suggestion
Have glossary in core repo, so definitions will be added early. Or some way to make decisions about new terms early, ideally while docs and core is written and not afterwards.
Requirements
The topic is a little complex, as there are several applications (or use cases), each with a little different requirements.
These points partially overlap!
Applications for glossaries:
1. (technical) a glossary for defining how a term is used and what it means, preferred spelling. This is not so much for end users, but rather for people writing documentation, writing and coding in core.
2. (BE user, translations in Crowdin): For some of the term definition this is relevant for translations too, but the scope is different: mostly backend user, not developer, so different terms and sometimes (slightly) different meanings.
3. Terms to be displayed in backend and for user (microcopy) which should be optimized for usability
4. Explains things to a person new to TYPO3 world – this is not as much scope of this issue but important too.
Workflow – how should workflow be for deciding / improving terms? It is often difficult to find results, because many things must be considered. Are there some general decisions we can make, general rules we can apply to terms to make this easier?
Existing glossaries:
- the official writing guide: https://guides.openstrategypartners.com/typo3-guide/writing-principles-and-guidelines/spelling-and-typo3-terminology
- Writing Documentation in Styleguide for Documentation: https://docs.typo3.org/m/typo3/docs-how-to-document/master/en-us/GeneralConventions/Glossary.html
- Crowdin: https://crowdin.com/translate/typo3-cms/1892/en-de?filter=basic&value=0
Reviews 0
No change resolves or names this issue in its commit message, and no comment links one.
Related issues 1
History 5
-
Georg Ringer commented 11/01/21, 18:55
-
Garvin Hicking changed Related to #90667 07/06/24, 06:28
-
Garvin Hicking commented and changed status
NewAccepted assigned to Garvin Hicking 07/06/24, 06:31We’ve started to collect terms and I’ll create a PR for the docs soon to get this going.
https://docs.google.com/spreadsheets/d/1qjCTsaGgifZAYhOV4Mtqall34h5Dyl5Z-1DzHBayBJU/ (Needs permission, currently internal because strategies involved – people who want to contribute there, let me know)
-
Riccardo De Contardi changed Tags Terminology 07/06/24, 10:21
-
Garvin Hicking commented and changed status
AcceptedClosed 11/06/24, 14:06Has been merged into: https://docs.typo3.org/m/typo3/writing-guide/main/en-us/writing-principles-and-guidelines/spelling-and-typo3-terminology.html
Closing for now, can be improved in follow-ups if anyone is up for it. ;)
we can create glossary also on crowdin and export/import those there