We frequently reference existing pylint checks in the documentation, especially for changelog entries. It would be great if those would link to the corresponding message page.

https://pylint.readthedocs.io/en/stable/whatsnew/3/3.3/index.html
https://pylint.readthedocs.io/en/stable/user_guide/messages/error/used-before-assignment.html

Ideally this would be a custom sphinx role like pylint or pylint-msg so we could reference it like this

:pylint:`used-before-assignment`

Reference

• https://www.sphinx-doc.org/en/master/development/tutorials/extending_syntax.html#extending-syntax-with-roles-and-directives
• (A bit outdated) https://doughellmann.com/posts/defining-custom-roles-in-sphinx/