diff --git a/reference/xmlwriter/functions/xmlwriter-write-cdata.xml b/reference/xmlwriter/functions/xmlwriter-write-cdata.xml
index 04fd66f1c5..54ee0f9b9e 100644
--- a/reference/xmlwriter/functions/xmlwriter-write-cdata.xml
+++ b/reference/xmlwriter/functions/xmlwriter-write-cdata.xml
@@ -48,6 +48,46 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="xmlwriter-write-cdata.example.basic">
+   <title>Basic <function>xmlwriter_write_cdata</function> Usage</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+// set up the document
+$xml = new XmlWriter();
+$xml->openMemory();
+$xml->setIndent(true);
+$xml->startDocument('1.0', 'UTF-8');
+$xml->startElement('mydoc');
+$xml->startElement('myele');
+
+// CData output
+$xml->startElement('mycdataelement');
+$xml->writeCData("text for inclusion as CData");
+$xml->endElement();
+
+// end the document and output
+$xml->endElement();
+$xml->endElement();
+echo $xml->outputMemory(true);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+<mydoc>
+ <myele>
+  <mycdataelement><![CDATA[text for inclusion as CData]​]></mycdataelement>
+ </myele>
+</mydoc>
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>