docs: use sphinx.ext.extlinks to avoid repeating links
We have a lot of repeated links in our docs. However, Sphinx has the sphinx.ext.extlinks
extension, that let's us automate linking.
While doing this, let's also simplify the custom roles we have, when possible.