From 968e0f4ef9eef35e090675f1c92ba2fcdf88ccef Mon Sep 17 00:00:00 2001
From: Patrick Lehmann <Paebbels@gmail.com>
Date: Tue, 1 Nov 2022 21:44:42 +0100
Subject: [PATCH] Documented BuildTheDocs.

---
 doc/JobTemplate/BuildTheDocs.rst  | 56 ++++++++++++++++++++++++-------
 doc/JobTemplate/PublishOnPyPI.rst |  6 ++--
 2 files changed, 46 insertions(+), 16 deletions(-)

diff --git a/doc/JobTemplate/BuildTheDocs.rst b/doc/JobTemplate/BuildTheDocs.rst
index 73f242c..f9e0cf7 100644
--- a/doc/JobTemplate/BuildTheDocs.rst
+++ b/doc/JobTemplate/BuildTheDocs.rst
@@ -3,6 +3,21 @@
 BuildTheDocs
 ############
 
+This jobs compiles the documentation written in ReStructured Text with Sphinx using BuildTheDocs.
+
+**Behavior:**
+
+1. Checkout repository.
+2. Build the documentation.
+3. Upload the HTML documentation as an artifact.
+
+**Dependencies:**
+
+* :gh:`actions/checkout`
+* :gh:`buildthedocs/btd`
+* :gh:`actions/upload-artifact`
+
+
 Instantiation
 *************
 
@@ -11,31 +26,46 @@ Simple Example
 
 .. code-block:: yaml
 
-   TBD
+   jobs:
+     BuildTheDocs:
+       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r0
+       with:
+         artifact: Documentation
 
 Complex Example
 ===============
 
-
-
 .. code-block:: yaml
 
-   TBD
+   jobs:
+     BuildTheDocs:
+       uses: pyTooling/Actions/.github/workflows/BuildTheDocs.yml@r0
+       needs:
+         - Params
+       with:
+         artifact: ${{ fromJson(needs.Params.outputs.params).artifacts.doc }}
+
 
 Template Parameters
 *******************
 
-TBD 1
-=====
+artifact
+========
 
-TBD
+Name of the documentation artifact.
 
-TBD 1
-=====
++----------+----------+--------------+
+| Required | Type     | Default      |
++==========+==========+==============+
+| yes      | string   | — — — —      |
++----------+----------+--------------+
 
-TBD
+Secrets
+*******
 
-Template Results
-****************
+This job template needs no secrets.
 
-*None*
+Results
+*******
+
+This job template has no output parameters.
diff --git a/doc/JobTemplate/PublishOnPyPI.rst b/doc/JobTemplate/PublishOnPyPI.rst
index ed5654d..22d953c 100644
--- a/doc/JobTemplate/PublishOnPyPI.rst
+++ b/doc/JobTemplate/PublishOnPyPI.rst
@@ -22,9 +22,9 @@ Setup a secret (e.g. ``PYPI_TOKEN``) in GitHub to handover the PyPI token to the
 
 **Dependencies:**
 
-* actions/download-artifact
-* actions/setup-python
-* geekyeggo/delete-artifact
+* :gh:`actions/download-artifact`
+* :gh:`actions/setup-python`
+* :gh:`geekyeggo/delete-artifact`
 
 
 Instantiation