github/datasette
1
0
Fork 0
mirror of https://github.com/simonw/datasette.git synced 2025-12-10 16:51:24 +01:00
Code Issues Projects Releases Packages Wiki Activity

@documented decorator plus unit test plus sphinx.ext.autodoc

Browse source 
New mechanism for marking datasette.utils functions that should be covered by the
documentation, then testing that they have indeed been documented.

Also enabled sphinx.ext.autodoc which can now be used to embed the documented
versions of those functions.

Refs #1176
This commit is contained in:
Simon Willison 2022-02-06 22:30:00 -08:00
commit d9b508ffaa
4 changed files with 43 additions and 4 deletions
Download patch file Download diff file Expand all files Collapse all files

2
docs/conf.py
View file

@ -31,7 +31,7 @@
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ["sphinx.ext.extlinks"]
extensions = ["sphinx.ext.extlinks", "sphinx.ext.autodoc"]
extlinks = {
"issue": ("https://github.com/simonw/datasette/issues/%s", "#"),