diff --git a/doc/cookbook/clutter-cookbook.xml.in b/doc/cookbook/clutter-cookbook.xml.in
index 06ab777eb..2d6f2cdb3 100644
--- a/doc/cookbook/clutter-cookbook.xml.in
+++ b/doc/cookbook/clutter-cookbook.xml.in
@@ -101,6 +101,10 @@
         empty brackets, e.g. <function>clutter_actor_set_size()</function>.
         </para>
       </listitem>
+      <listitem>
+        <para>Use the &lt;note&gt; element for asides which might
+        otherwise interrupt the flow of the recipe.</para>
+      </listitem>
     </itemizedlist>
 
   </appendix>