diff --git a/doc/source/developer/docs.rst b/doc/source/developer/docs.rst
index cce4ca3..6a7256e 100644
--- a/doc/source/developer/docs.rst
+++ b/doc/source/developer/docs.rst
@@ -20,6 +20,11 @@
 a specific string into a configuration file) should use the RST
 ````literal```` syntax.
 
+YAML supports boolean values expressed with or without an initial
+capital letter.  In examples and documentation, use ``true`` and
+``false`` in lowercase type because the resulting YAML is easier for
+users to type and read.
+
 Terminology
 ~~~~~~~~~~~