Properly define custom Sphinx roles

[jivanpal]

For guidance, see:

• https://www.sphinx-doc.org/en/master/extdev/index.html
• https://doughellmann.com/posts/defining-custom-roles-in-sphinx/
• https://opensource.com/article/18/11/building-custom-workflows-sphinx