diff --git a/docs/features/interface/human_interface_guidelines/writing_style.md b/docs/features/interface/human_interface_guidelines/writing_style.md index e1805cf8..4cccd4ca 100644 --- a/docs/features/interface/human_interface_guidelines/writing_style.md +++ b/docs/features/interface/human_interface_guidelines/writing_style.md @@ -11,6 +11,11 @@ - Not capitalizing entity names is an arguable guideline, but avoids many fuzzy cases. +- Brand / product names such as *Cycles*, *Grease Pencil*, *Line Art*, *Freestyle* + are always capitalized. EEVEE is always uppercase. + +- “Channel” identifiers, like _X_, _Y_, _Z_, _R_, _G_, _B_, etc. are always capitalized. + - Do not use abbreviations like _verts_, _VGroups_, _loc_, or _rot_, _fac_. Instead, use plain words like _vertices_, _vertex groups_, _location_, _rotation_, _factor_. @@ -20,15 +25,13 @@ much longer, and it helps keeping consistent styling over the whole UI. -- “Channel” identifiers, like _X_, _Y_, _Z_, _R_, _G_, _B_, etc. are always capitalized. - - Do not use implementation specific language. !!! Example "Examples" - Instead of _ID_, use _data-block_. - Do not use terms like _flag_, _string_, _RNA_, _DNA_. -- Don't use pronouns, such as _you_. This sounds like an accusation towards the user.
+- Do not use pronouns, such as _you_. This sounds like an accusation towards the user.
!!! Example **Don't**: _Your mesh is very dense_