Vorschlag zu Naming Conventions FIR/OpenApi. Bei Konsens bzw. Entscheidung kann diese Seite ggf. in den Dokumentationsbereich verschoben werden.
...
Was Wie Wo
[Entity] schema
Zur definition Definition von Entity (Model-Klassen) verwenden wir Pascal case.
Examples: TroubleTicket, QueryServiceQualification, CustomerBill
[Entity] Attributes
Zur definition von Entity Attributes ((Model-Properties)) verwenden wir Camel case.
...
Characteristics (Key/Value)
Zur definition Definition von Characteristics verwenden wir Snake case.
...
Beispiel: https://serverRoot/tmf-api/productOrdering/v4
Enumerations
Zur Definition von Enumerations verwenden wir Camel case.
Discriminator
Discriminator Werte sind identisch mit dem Namen der Entity (Pascal case).
Anti-Pattern
Die Vermeidung der aufgeführten Anti-Pattern sorgt dafür, das eine verlustfreie Transformation von einem in das andere Format möglich ist. Das ist insbesondere wichtig für Code Generatoren und andere Tools.
...