.. Copy and rename this template in the format reST-doc-title.rst.
.. Update "Template - reST Documentation" with the Documents Title.
.. Update all title-here placeholders with the document title.
.. Update reST-index.rst to include this document.
.. Delete these instructions before pushing the final doc to production.

.. include:: /extras.rst.txt
.. highlight:: rst
.. index:: reST; Title Here
.. _rest-title-here:

==================
reST Documentation
==================

|

What is it: One or two lines description

Why does it exist: One or two lines description

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. _how-to-title-here:


How-to
======

How-to: Write one or two lines describing the in-depth explanation
that follows.

Use admonitions, inline-tabs and other reST tools to get a concise
message across.

.. tab:: How it Looks

    Demonstrate what the reST code will look like here.

.. tab:: reST syntax

   .. code-block:: rest
        :linenos:

        Add reST here


+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. _reference-title-here:

Reference
=========

|

:sep:`Many other examples follow below, in the How it Looks and reST syntax
tabs.`

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. index:: reST directives; title-here
.. .. _reference-title-here:

First Example
-------------

.. tab:: How it Looks

        Have reST syntax to render how an example looks here.

.. tab:: reST syntax

    .. code-block:: rest
        :linenos:

        Have the reST syntax here; this should mirror the How it Looks tab.

|

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

.. _discussion-title-here:

Discussion
==========

|

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

|

Further Reading
===============

|

For further interesting reading on this topic, see `Name of the link
<link web address>`__.