@tutorial
=============================

.. rst:directive:: @tutorial

   :Syntax: ``@tutorial <tutorialID>``
   :Overview:

      The :rst:dir:`@tutorial` tag inserts a link to a tutorial file that is provided
      as part of the documentation.
      See the :ref:`tutorials` for instructions on creating tutorials.

      You can use the :rst:dir:`@tutorial` tag more than once in a single JSDoc comment.

   :Examples:

      In the following example, the documentation for ``MyClass`` will link to
      the tutorials that have the identifiers ``tutorial-1`` and ``tutorial-2``:

      .. code-block:: js
         :caption: Using the @tutorial tag

         /**
          * Description
          * @class
          * @tutorial tutorial-1
          * @tutorial tutorial-2
          */
         function MyClass() {}