*****************
Writing Tutorials
*****************

.. TODO::

   Show how the ``.. literalinclude::`` directive can be used to selectively
   include pieces of a source file. The source file can reside in the testing
   directory and be built as part of the test suite ensuring the documentation
   stays up to date.