diff --git a/reference/xmlwriter/functions/xmlwriter-write-attribute.xml b/reference/xmlwriter/functions/xmlwriter-write-attribute.xml
index f1944a12ea..48e0ea048f 100644
--- a/reference/xmlwriter/functions/xmlwriter-write-attribute.xml
+++ b/reference/xmlwriter/functions/xmlwriter-write-attribute.xml
@@ -58,6 +58,40 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="xmlwriter-write-attribute.example.intermix">
+   <title>Intermixing Sub-elements and Attributes</title>
+   <para>
+     If writing sub-elements and attributes is intermixed, any attempt to write
+     attributes after the first sub-element will fail and return false.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$xml = new XMLWriter();
+$xml->openMemory();
+
+$xml->startElement('element');
+$xml->writeAttribute('attr1', '0');
+$xml->writeElement('subelem', '0');
+var_dump($xml->writeAttribute('attr2', '0'));
+$xml->endElement();
+
+echo $xml->flush();
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+bool(false)
+<element attr1="0"><subelem>0</subelem></element>
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>