Improved SphinxDocumentation and LaTeXDocumentation.

This commit is contained in:
Patrick Lehmann
2025-08-31 01:46:15 +02:00
parent 0adc72d26a
commit bb03bdcc11
9 changed files with 156 additions and 46 deletions

View File

@@ -592,3 +592,11 @@ coverage_report_json
[tool.coverage.json]
output = "report/coverage/coverage.json"
.. _JOBTMPL/LatexDocumentation/Optimizations:
Optimizations
*************
This template offers no optimizations (reduced job runtime).

View File

@@ -740,3 +740,20 @@ params
* ``params['typing']`` |rarr| ``artifact_names['statictyping_html']``
* ``params['package']`` |rarr| ``artifact_names['package_all']``
* ``params['doc']`` |rarr| ``artifact_names['documentation_html']``
.. _JOBTMPL/LatexDocumentation/Optimizations:
Optimizations
*************
This template offers no optimizations (reduced job runtime).
Nontheless, the generated output :ref:`JOBTMPL/Parameters/Output/python_jobs` is influenced by many input parameters
generating :math:`N^2` many Python job combinations, which in turn will influence the overall pipeline runtime and how many
jobs (parallel VMs) are needed to execute the matrix.
.. hint::
Some VM images (macOS, Windows) have parallelism limitations and run slower then Ubuntu-based jobs. Additionally,
environments like MSYS2 require an additional setup time increasing a jobs runtime segnificantly.

View File

@@ -449,3 +449,11 @@ pr_number
:ref:`merge commit <JOBTMPL/PrepareJob/Output/is_merge_commit>` and the located pull-request's title
for this commit matches :ref:`JOBTMPL/PrepareJob/Input/release_tag_pattern`, otherwise returns an
empty string ``''``.
.. _JOBTMPL/LatexDocumentation/Optimizations:
Optimizations
*************
This template offers no optimizations (reduced job runtime).