schema_style_guide.rst: add guidance for authoring titles

open-contracting · Oct 9, 2023 · 35d1fff · 35d1fff
1 parent 554203a
commit 35d1fff
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/docs/meta/schema_style_guide.rst b/docs/meta/schema_style_guide.rst
@@ -246,6 +246,12 @@ Field and code names
 
    Until OCDS 2.0, publishers must use the ``tender`` term, and not choose their own terms, in order to maintain interoperability. The choice of a term is cosmetic; it's not semantic. A field's description, not its name, is semantic.
 
+Field and code titles
+---------------------
+
+- Use `sentence case <https://en.wikipedia.org/wiki/Letter_case#Sentence_case>`__.
+- Field titles should not include their parent's title, e.g. ``Title`` not ``Tender title``, ``Description`` not ``Award description``, etc.
+
 Field and code descriptions
 ---------------------------