diff options
| author | Daniel Schadt <kingdread@gmx.de> | 2022-12-29 16:20:18 +0100 |
|---|---|---|
| committer | Daniel Schadt <kingdread@gmx.de> | 2022-12-29 16:20:18 +0100 |
| commit | 28d44ca764955cb042e5d1821ffc23e2b9aba07c (patch) | |
| tree | 2aa45eb096dca2a18baf0b43a3a0deabfbdea88f /pyproject.toml | |
| parent | 75368c69f45b2995e1adcd58795f5c33fbf5b9b3 (diff) | |
| download | fietsboek-28d44ca764955cb042e5d1821ffc23e2b9aba07c.tar.gz fietsboek-28d44ca764955cb042e5d1821ffc23e2b9aba07c.tar.bz2 fietsboek-28d44ca764955cb042e5d1821ffc23e2b9aba07c.zip | |
generate & build API docs for the Python package
We have so many nice docstrings, but they aren't really rendered
anywhere (expect locally in your IDE), as we did not include the API
docs anywhere.
This change uses sphinx-apidoc to generate autodoc stubs for Sphinx, so
that the docstrings are actually rendered to HTML. This is not perfect
yet (I'm not too happy about the default modules.rst simply listing one
package), but it is good enough for the start and makes it possible to
actually browse the docstrings in a browser.
Diffstat (limited to 'pyproject.toml')
| -rw-r--r-- | pyproject.toml | 1 |
1 files changed, 1 insertions, 0 deletions
diff --git a/pyproject.toml b/pyproject.toml index 292351a..4763834 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -61,6 +61,7 @@ optional = true [tool.poetry.group.docs.dependencies] Sphinx = "^5.3" +sphinx-autodoc-typehints = "^1.19.5" [tool.poetry.group.testing] optional = true |