Paul J. Dorn 481dbf2e9b
Publish full exception when the application fails to load (#3462)
* Python3: refactor returned traceback

Exceptions provide __traceback__ reference since Python 3.0
(and creating cyclic references has not been big deal since Python 2.2)

* --reload: publish entire exception, not just traceback

This is dangerous insofar as the exception text is more
likely to contain secrets than the quoted lines from traceback are.

However, the difference between the two is minor compared to the
primary danger of enabling this on a production machine, so focus
on that instead!
2026-01-25 09:41:39 +01:00
..
2026-01-23 01:20:03 +01:00
2026-01-23 01:20:03 +01:00

Generate Documentation
======================

Requirements
------------

Install the documentation dependencies with::

    pip install -r requirements_dev.txt

This provides MkDocs with the Material theme and supporting plugins.


Build static HTML
-----------------
::

    mkdocs build

The rendered site is emitted into the ``site/`` directory.


Preview locally
---------------
::

    mkdocs serve

This serves the documentation at http://127.0.0.1:8000/ with live reload.