Handling cross references for paragraphs #426
Description
MAPDL documentation contains a lot of links referring to paragraph sections with no title.
However, Sphinx only accepts labels before a heading or a rubric.
Thus, calling the following NSORTinputneed reference doesn't render correctly:
.. _NSORTinputneed:
Works only if failure criteria information is provided. (For more information, see the documentation
for the :ref:`fc` and :ref:`tb` commands.)
Addressing the issue
An easy way to fix it would be by adding a default title to each paragraph section with a rubric link object, for instance:
.. _NSORTinputneed:
.. rubric:: NSORTinputneed
Works only if failure criteria information is provided. (For more information, see the documentation
for the :ref:`fc` and :ref:`tb` commands.)