[Docutils-develop] Doctree validation

[Brecht M. <br...@mo...>]

Hi,

>From time to time, I receive bug reports for rinohtype that are caused 
by an invalid document tree. Sphinx plugins sometimes fail to respect 
the separation between body and inline elements. For example, Breathe 
adds a literal_block node as a child of a paragraph node [1]. While 
most Sphinx builders happily render invalid document trees, I like to 
be more strict about it.

Of course, if Sphinx plugin authors do not get any feedback when 
building an invalid document tree, it's easy to make this mistake. 
Therefore, I would like to propose to add some basic document tree 
checks to docutils. What do you think?

P.S. Many thanks for the new styling of the documentation on 
docutils.sourceforge.io. Much appreciated!

Cheers,
Brecht

[1] https://github.com/brechtm/rinohtype/issues/312