diff --git a/docs/styleguide.rst b/docs/styleguide.rst
index 2998e90963..3162868fb7 100644
--- a/docs/styleguide.rst
+++ b/docs/styleguide.rst
@@ -24,6 +24,18 @@ Whitespace
 
 Blocks should be indented with 3 spaces, and no tabs
 
+Code blocks
+===========
+
+Code blocks should be created using
+
+::
+
+   This is regular text.
+
+   ::
+
+      This is a code block.
 
 Headings
 ========