doc: broken link on troubleshooting-mon page

[falcon78921]

• References tracker ticket
• Updates documentation if necessary
• Includes tests for new functionality or reproducer for bug

Fixes: https://tracker.ceph.com/issues/37451

This fix involves adding :ref: labels to the add-or-rm-mons.rst
page. I also added :ref: labels for other headings within
add-or-rm-mons.rst (for future reference).

Signed-off-by: James McClune jmcclune@mcclunetechnologies.net

[falcon78921]

jenkins render docs

[ceph-jenkins]

Doc render available at http://docs.ceph.com/ceph-prs/25312/

[joscollin]

Looks good. But I see that the other places in the documentation conventionally maintain the ref labels with a hyphen.

For example:
rados/configuration/mon-config-ref.rst: :ref:CRUSH map tunables for

Could you please fix that?

[falcon78921]

@joscollin I noticed that. In past PR's, I followed suit with hyphenating :ref: labels.

Like here: https://github.com/ceph/ceph/pull/24785/files#diff-017fae76d50fa0791f035bf95f5a274dR513

The reason for putting the full title is simplicity. I noticed that many reference links in the Ceph documentation are broken. IMO, putting the whole title would better organize sections for reference, instead of having to lookup the :ref: label in raw format. Most section titles/commands are unique, so this could work. I would be more than happy to start converting all sections/subsections of documentation so they have :ref: labels. Just a recommendation...

If you still want me to fix, please let me know.

[joscollin]

@falcon78921 Send an email to ceph-devel about your recommendation.

[falcon78921]

@joscollin I squashed the commits into ca05e45. The corrections have been made.