Workaround (possibly temporary) for docs build problem. NB can also use autodoc_suppress_warnings=['index'].

Author: pp-mo

docs/src/conf.py

@@ -217,6 +217,7 @@ def _dotv(version):
 autopackage_name = ["iris"]
 autoclass_content = "both"
 modindex_common_prefix = ["iris"]
+# autodoc_suppress_warnings = ["index"]
 
 # -- apidoc extension ---------------------------------------------------------
 # See https://github.com/sphinx-contrib/apidoc

lib/iris/experimental/ugrid.py

@@ -28,10 +28,31 @@
 
 from .._deprecation import warn_deprecated
 from ..ugrid.load import PARSE_UGRID_ON_LOAD, load_mesh, load_meshes
-from ..ugrid.mesh import Connectivity, Mesh, MeshCoord
+from ..ugrid.mesh import Connectivity as _ConnectivityClass
+from ..ugrid.mesh import Mesh as _MeshClass
+from ..ugrid.mesh import MeshCoord as _MeshCoordClass
 from ..ugrid.save import save_mesh
 from ..ugrid.utils import recombine_submeshes
 
+
+# Generate own duplicate definitions of the duplicated classes,
+# purely because this prevents Sphinx from complaining about duplicate index items.
+# (e.g. "WARNING: duplicate object description of iris.ugrid.mesh.Mesh, other instance
+#       in generated/api/iris.experimental.ugrid, use :no-index: for one of them"
+# )
+# For some reason, this only happens for classes, and not functions.
+class Connectivity(_ConnectivityClass):
+    pass
+
+
+class Mesh(_MeshClass):
+    pass
+
+
+class MeshCoord(_MeshCoordClass):
+    pass
+
+
 __all__ = [
     "Connectivity",
     "Mesh",