Refer to ansys-templates in template.rst

Author: jorgepiloto

doc/source/library_description/template.rst

@@ -2,21 +2,67 @@
 Library Template
 ################
 
-Within the `PyAnsys Organization <https://github.com/pyansys>`_, there
-is a `template repository <https://github.com/pyansys/template>`_
-where you can `create a repository from a template`_ and create a 
-PyAnsys project that follows the guidelines specified in this developer's
-guide.
+If you are about to start a new PyAnsys project from scratch, please consider
+using the `ansys-templates`_ tool. This is a command line tool which allows you
+to dynamically create a PyAnsys project from different available templates.
 
-The template repository contains a generalized library skeleton that includes:
+.. note::
 
-- Library skeleton with sample classes and methods
-- Sample documentation build including customized templates
-- Sample GitHub actions specific to PyAnsys libraries
-- Licensing, example README, and setup files
-- ``.gitignore`` and other requirements files
+   Check the `pyansys-templates documentation`_ for guidelines on how to use
+   the `ansys-templates`_ command line interface.
 
-To use this template, `create a repository from a template`_.
 
+PyAnsys Available Templates
+===========================
 
-.. _Create a repository from a template: https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template
+There are two templates to be used as basis for PyAnsys projects. These are the
+``pyansys`` and the ``pyansys-advanced`` templates.
+
+
+PyAnsys template 
+----------------
+
+The ``pyansys`` template ships only with the required directories and files to
+quickly setup a PyAnsys compliant project:
+
+- Provides a ``src/ansys/product/library/`` layout.
+- Includes a ``setup.py`` file.
+- Generates a ``doc/`` and a ``tests/`` directories.
+- Generic ``.gitignore`` for Python libraries.
+- Minimum required build, doc and test requirements. Dependencies are hosted in
+  ``requirements_<type>.txt`` files, in the project's root directory.
+- Usual files: ``README.rst`` and ``LICENSE``.
+
+Create a new project based on the ``pyansys-advanced`` template by running:
+
+.. code:: bash
+
+   ansys-templates new pyansys
+
+
+PyAnsys Advanced Template
+-------------------------
+
+The ``pyansys-advanced`` is an enhanced version of the ``pyansys`` template. It
+ships with the same files as this last template except:
+
+- It allows you to select the build system among `flit`_, `poetry`_ or
+  `setuptools`_. Refer to :ref:`packaging` for more about build systems.
+- Uses `Tox`_ for testing and tasks automation.
+- Includes a GitHub actions workflow for testing coding style, running the test
+  suite and building documentation.
+- Uses `pre-commit`_ for checking coding style.
+
+Create a new project based on the ``pyansys-advanced`` template by running:
+
+.. code:: bash
+
+   ansys-templates new pyansys-advanced
+
+.. _ansys-templates: https://github.com/pyansys/pyansys-templates
+.. _flit: https://flit.readthedocs.io/en/latest/
+.. _poetry: https://python-poetry.org/
+.. _pre-commit: https://pre-commit.com/
+.. _pyansys-templates documentation: https://templates.pyansys.com/getting_started/index.html
+.. _setuptools: https://pypi.org/project/setuptools/
+.. _Tox: https://tox.wiki/en/latest/