diff --git a/docs/CodingStandards.rst b/docs/CodingStandards.rst
index fa7970221a0..680747be799 100644
--- a/docs/CodingStandards.rst
+++ b/docs/CodingStandards.rst
@@ -153,6 +153,9 @@ being aware of:
 * While most of the atomics library is well implemented, the fences are
   missing. Fortunately, they are rarely needed.
 * The locale support is incomplete.
+* ``std::initializer_list`` (and the constructors and functions that take it as
+  an argument) are not always available, so you cannot (for example) initialize
+  a ``std::vector`` with a braced initializer list.
 
 Other than these areas you should assume the standard library is available and
 working as expected until some build bot tells you otherwise. If you're in an