Added some cross references.

doc/JobTemplate/ArtifactCleanUp.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/ArtifactCleanup:
+
 ArtifactCleanUp
 ###############
 

doc/JobTemplate/BuildTheDocs.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/BuildTheDocs:
+
 BuildTheDocs
 ############
 

doc/JobTemplate/CoverageCollection.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/CodeCoverage:
+
 CoverageCollection
 ##################
 

doc/JobTemplate/Package.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/Package:
+
 Package
 #######
 

doc/JobTemplate/Parameters.rst

@@ -1,8 +1,10 @@
+.. _JOBTMPL/Parameters:
+
 Parameters
 ##########
 
-The `Parameters` job template is a workaround for the limitations of GitHub Actions to handle global variables in
+The ``Parameters`` job template is a workaround for the limitations of GitHub Actions to handle global variables in
-GitHub Actions workflows (see [actions/runner#480](https://github.com/actions/runner/issues/480)).
+GitHub Actions workflows (see `actions/runner#480 <https://github.com/actions/runner/issues/480>`__.
 
 It generates output parameters with artifact names and a job matrix to be used in later running jobs.
 

doc/JobTemplate/PublishOnPyPI.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/PyPI:
+
 PublishOnPyPI
 #############
 

doc/JobTemplate/UnitTesting.rst

@@ -1,3 +1,5 @@
+.. _JOBTMPL/UnitTesting:
+
 UnitTesting
 ###########
 
@@ -67,11 +69,11 @@ requirements
 
 Python dependencies to be installed through pip.
 
-+----------+----------+----------+
++----------+----------+---------------------------------+
-| Required | Type     | Default  |
+| Required | Type     | Default                         |
-+==========+==========+==========+
++==========+==========+=================================+
 | optional | string   | ``-r tests/requirements.txt``   |
-+----------+----------+----------+
++----------+----------+---------------------------------+
 
 
 pacboy

doc/JobTemplate/index.rst

@@ -1,4 +1,32 @@
 Overview
 ########
 
+**Global Templates**
 
+* :ref:`JOBTMPL/Parameters`
+
+**Unit Tests, Code Coverage, ...**
+
+* :ref:`JOBTMPL/UnitTesting`
+* :ref:`JOBTMPL/CodeCoverage`
+* Static type checking
+
+**Build and Packaging**
+
+* :ref:`JOBTMPL/Package`
+
+**Documentation**
+
+* Verify docs
+* :ref:`JOBTMPL/BuildTheDocs`
+
+**Publishing**
+
+* :ref:`JOBTMPL/GitHubReleasePage`
+* :ref:`JOBTMPL/PyPI`
+* Publish test results
+* Publish to github pages
+
+**Cleanups**
+
+* :ref:`JOBTMPL/ArtifactCleanup`

doc/index.rst

@@ -36,8 +36,42 @@ Introduction
 
 
 
-Package Details
+GitHub Action Job Templates
-***************
+***************************
+
+**Global Templates**
+
+* :ref:`JOBTMPL/Parameters`
+
+**Unit Tests, Code Coverage, ...**
+
+* :ref:`JOBTMPL/UnitTesting`
+* :ref:`JOBTMPL/CodeCoverage`
+* Static type checking
+
+**Build and Packaging**
+
+* :ref:`JOBTMPL/Package`
+
+**Documentation**
+
+* Verify docs
+* :ref:`JOBTMPL/BuildTheDocs`
+
+**Publishing**
+
+* :ref:`JOBTMPL/GitHubReleasePage`
+* :ref:`JOBTMPL/PyPI`
+* Publish test results
+* Publish to github pages
+
+**Cleanups**
+
+* :ref:`JOBTMPL/ArtifactCleanup`
+
+
+GitHub Actions
+**************
 
 
 Contributors