Set up intersphinx, use it with flask_login

docs/source/conf.py

@@ -37,6 +37,7 @@
     'sphinx.ext.todo',
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
+    'sphinx.ext.intersphinx',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -352,3 +353,10 @@
 # If true, do not generate a @detailmenu in the "Top" node's menu.
 #
 # texinfo_no_detailmenu = False
+
+### Intersphinx
+
+intersphinx_mapping = {
+    'python': ('https://docs.python.org/3', None),
+    'flask_flatpages': ('https://flask-login.readthedocs.io/en/latest/', None),
+}

sipa/model/user.py

@@ -81,7 +81,9 @@ def get(cls: Type[T], username: str) -> T:
     def from_ip(cls: Type[T], ip: str) -> T:
         """Return a user based on an ip.
 
-        If there is no user associated with this ip, return AnonymousUserMixin.
+        If there is no user associated with this ip, return
+        :py:class:`~flask_login.AnonymousUserMixin`.
+
         :param ip: the ip
         :return: the user object
         """