
How to Write this Manual
========================================================================

.. figure:: https://imgs.xkcd.com/comics/manuals.png
    :align: center
    :alt: A comic strip of xkcd joking that the most unhelpful tool is
          one whose manual starts with "How to read this manual".

    Image credit: "Manuals" from xkcd by Randall Munroe (https://xkcd.com/1343/)

Rather than begin with "How to read this manual" (hopefully, that task
is sufficiently self-evident), this documentation ends with guidelines
for writing future versions.
