Closed
Description
One thing I frequently have to fix is people using incorrect section headers, e.g. 'Return' instead of 'Returns'. The warning in this case just looks like this:
Unknown section Return
Most Sphinx warnings do a reasonable job of telling me which file or docstring the problem was in, which makes it much easier to fix.
Activity
marscher commentedon Nov 19, 2014
this applies to all sections. There is no useful information given, where to find this. Of course one can grep the location, but why now directly providing it?
jnothman commentedon Sep 17, 2017
Fixed in #101