Issue Task Closed

#95822General glossary for term definitions + workflow for introducing / improving terms

Sybille Peters 10/30/21, 10:03 updated 11/06/24, 14:06

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:

Reviews 0

No change resolves or names this issue in its commit message, and no comment links one.

History 5

  1. Georg Ringer commented 11/01/21, 18:55

    we can create glossary also on crowdin and export/import those there

  2. Garvin Hicking changed Related to #90667 07/06/24, 06:28

  3. Garvin Hicking commented and changed status New Accepted assigned to Garvin Hicking 07/06/24, 06:31

    We’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)

  4. Riccardo De Contardi changed Tags Terminology 07/06/24, 10:21

  5. Garvin Hicking commented and changed status Accepted Closed 11/06/24, 14:06

    Has 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. ;)