[doc] Modify the automated redirection to user_guides

See discussion: #6628 (comment)

Co-authored-by: Daniël van Noord <[email protected]>

Author: Pierre-Sassoulas

doc/conf.py

@@ -45,13 +45,18 @@
     "sphinx_reredirects",
 ]
 
+
+# Single file redirect are handled in this file and can be done by a pylint
+# contributor. See:
 # https://documatt.gitlab.io/sphinx-reredirects/usage.html
+# Directory redirect are handled in ReadTheDoc admin interface and can only be done
+# by pylint maintainer at the following URL:
+# https://readthedocs.org/dashboard/pylint/redirects/
 redirects: dict[str, str] = {
     # "<source>": "<target>"
     "intro": "index.html",
     "support": "contact.html",
     "user_guide/ide-integration": "installation.html",
-    "messages/index": "user_guide/messages/index.html",
     "messages/messages_introduction": "user_guide/messages/index.html",
     "messages/messages_list": "user_guide/messages/messages_overview.html",
     "user_guide/message-control": "user_guide/messages/message-control.html",