doc: fix Sphinx complaints and some rendering errors

Fix 25 criticals, errors, and warnings from Sphinx.
Some of the changes did not change rendering but most fixed unintended
rendering, broken link etc.
Change Mon to Monitor in ceph-secrets.rst.

Signed-off-by: Ville Ojamo <git2233+ceph@ojamo.eu>