I scanned rolling packages, and looked for packages with a conf.py in a standard location: doc/ or doc/source/. I found 18. Of these, 10 had serious failures (either no rosdoc2 result at all, or failure to show intended documentation:
event_camera_py (rst files not shown; failed READMR include)
mrpt2
The reasons were varied, but some common reasons:
error in user conf.py caused abort
.rst files has .. include sections that referenced files not available in our wrapping
Of those who define conf.py, several would be better off with our newer rosdoc2 implementation rather than trying to roll their own. In others, the result would be better under our new documentation section rather than replacing all of the rosdoc2 output.
I scanned rolling packages, and looked for packages with a conf.py in a standard location: doc/ or doc/source/. I found 18. Of these, 10 had serious failures (either no rosdoc2 result at all, or failure to show intended documentation:
conf.py failures:
The reasons were varied, but some common reasons:
.. include
sections that referenced files not available in our wrappingOf those who define conf.py, several would be better off with our newer rosdoc2 implementation rather than trying to roll their own. In others, the result would be better under our new documentation section rather than replacing all of the rosdoc2 output.