It creates odd wording otherwise. Keep the reference, update the title using Sphinx notation.
- Also minor adjustments in the docs (wording, formatting, links, etc). Fix #2589
Signed-off-by: Abhijeet Kasurde <akasurde@redhat.com>