sphinx_rtd_theme and numpydoc not yet compatible with sphinx 2.0
Starting with sphinx's 2.0 release, the combination sphinx_rtd_theme (0.4.3) and numpydoc (0.9.1) isn't rendered incorrectly. Sphinx 2.0 renders parameter listings as description lists instead of tables. For now sphinx should be pinned below 2.0 and the progress on numpy/numpydoc/issues/215 should be monitored. However it is likely that this will require further changes to the theme overrides file.
Patch formatting for:
-
"Parameter" and "Returns" sections. -
Signature formatting (Python and click commands) -
References (labels) and footnotes -
Multi-line wrapping in tables (significant for documentation of command options)
Edited by Lars Grüter