Set Sphinx option nitpicky=True

doc/conf.py

@@ -39,12 +39,8 @@
 # html_extra_path.
 exclude_patterns = ["_build", "README.rst", "Thumbs.db", ".DS_Store"]
 
-nitpick_ignore_regex = {
-    # These occur because there is no .. py:module:: directive for the *top-level*
-    # module or package in the respective documentation and inventories.
-    # TODO Remove once the respective docs are fixed
-    ("py:mod", "message_ix"),
-}
+# Warn about *all* references where the target cannot be found
+nitpicky = True
 
 # A string of reStructuredText that will be included at the beginning of every source
 # file that is read.

ixmp/core/scenario.py

@@ -353,7 +353,7 @@ def items(
             If given, only iterate over items where one of the item dimensions is
             `indexed_by` the set of this name.
         par_data : bool, optional
-            If :any:`True` (the default) and `type` is :data:`.ItemType.PAR`, also
+            If :any:`True` (the default) and `type` is :attr:`.ItemType.PAR`, also
             iterate over data for each parameter.
 
         Yields
@@ -454,7 +454,7 @@ def init_item(
 
         Parameters
         ----------
-        item_type : ItemType
+        item_type : .ItemType
             The type of the item.
         name : str
             Name of the item.

ixmp/model/base.py

@@ -13,7 +13,7 @@
 
 
 class ModelError(Exception):
-    """Error in model code, e.g. :meth:`.Model.run`."""
+    """Error in model code—that is, :meth:`.Model.run` or other code called by it."""
 
 
 class Model(ABC):

ixmp/report/util.py

@@ -12,7 +12,7 @@ def dims_for_qty(data):
     If *data* is a :class:`pandas.DataFrame`, its columns are processed;
     otherwise it must be a list.
 
-    :data:`RENAME_DIMS` is used to rename dimensions.
+    :data:`.RENAME_DIMS` is used to rename dimensions.
     """
     if isinstance(data, pd.DataFrame):
         # List of the dimensions