Notice the outer paragraph that comes with li, which contains inner paragraphs, that's invalid in html. I noticed this while looking at #4227 (apparently the outer p was not there in 2017). I don't know if the issue comes from sphinx or docutils (I have 0.16).
empty __init__.py, sphinx-quickstart, add .. autofunction:: a.f to index.rst and 'sphinx.ext.autodoc' to extensions in conf.py, run PYTHONPATH=. make clean html, and look at _build/html/index.html.
Expected behavior
Valid (x)html. The outer <p> doesn't look very useful to me (and the inner div and p seem redundant), but I am not an expert in html.
Environment info
OS: Linux Debian testing x86_64
Python version: 3.9.2
Sphinx version: 3.4.3 (from debian) or 4.1.0 (from github)
Describe the bug The generated html contains
Notice the outer paragraph that comes with
li
, which contains inner paragraphs, that's invalid in html. I noticed this while looking at #4227 (apparently the outerp
was not there in 2017). I don't know if the issue comes from sphinx or docutils (I have 0.16).To Reproduce a.py:
empty
__init__.py
,sphinx-quickstart
, add.. autofunction:: a.f
to index.rst and'sphinx.ext.autodoc'
to extensions in conf.py, runPYTHONPATH=. make clean html
, and look at_build/html/index.html
.Expected behavior Valid (x)html. The outer
<p>
doesn't look very useful to me (and the inner div and p seem redundant), but I am not an expert in html.Environment info