Improve wording

hugovk · AA-Turner · web-flow · commit b78542a33257 · 2025-08-17T20:43:56.000+03:00
Co-authored-by: Adam Turner &lt;9087854+AA-Turner@users.noreply.github.com&gt;
diff --git a/documentation/style-guide.rst b/documentation/style-guide.rst
@@ -67,8 +67,10 @@ Some terms and words deserve special mention. These conventions should
 be used to ensure consistency throughout the documentation:
 
 boolean
-  Lowercase in most cases.
-  Uppercase for Boolean mathematics and Boolean logic.
+  Lowercase in most instances.
+  Uppercase for *Boolean mathematics* and *Boolean logic*.
+  To refer to the Python or C data type, prefer using the exact,
+  abbreviated name with appropriate markup (for example, ``:type:`bool```).
 
 C API
   Python's `API <https://docs.python.org/3/c-api/>`_ used by C programmers
