This was sparked because I noticed that the classes that were newly documented in #86 aren't actually showing up on transaction.readthedocs.io, despite the new build that occurred because of in #87. I didn't see anything in the logs, but we'll see what happens after this.
conf.py: Use default autodoc flags, and prepare for Sphinx 2.0.
conf.py: Read the correct version number for transaction.
conf.py: Add intersphinx mappings for stdlib and ZODB.
conf.py: Make the default role be object references, enabling IThing instead of :class:IThing for prettier docstrings.
interfaces.py: Cross references.
interfaces.py: ITransaction: Remove outdated docs about using a single transaction object more than one time. That doesn't work anymore.
interfaces.py: Simplify copied documentation, especially for the various ITransaction hook methods.
api.rst: DRY, use the default flags.
convenience.rst, integrations.rst: Fix compatibility with Sphinx 2 and straighten adornments
Previously they raised "TypeError: '_traversal_list' object is not reversible"
from sphinx.util.nodes line 151 apply_source_workaround.
jamadden
commented
4 years ago
This was sparked because I noticed that the classes that were newly documented in #86 aren't actually showing up on transaction.readthedocs.io, despite the new build that occurred because of in #87. I didn't see anything in the logs, but we'll see what happens after this.
IThinginstead of :class:IThingfor prettier docstrings.convenience.rst, integrations.rst: Fix compatibility with Sphinx 2 and straighten adornments
Previously they raised "TypeError: '_traversal_list' object is not reversible" from sphinx.util.nodes line 151 apply_source_workaround.