Handling cross references for paragraphs

[clatapie]

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.)

Links

• nsort: feat: post1 submodule (2/2) pymapdl#4003 (comment)
• pdef: feat: post1 submodule (2/2) pymapdl#4003 (comment)