[FB] [PI-3478] Add resolve doc-strings

lib/iris/common/__init__.py

@@ -3,7 +3,10 @@
 # This file is part of Iris and is released under the LGPL license.
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
+"""
+A package for provisioning common Iris infrastructure.
 
+"""
 
 from .lenient import *
 from .metadata import *

lib/iris/common/lenient.py

@@ -3,6 +3,10 @@
 # This file is part of Iris and is released under the LGPL license.
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
+"""
+Provides the infrastructure to support lenient client/service behaviour.
+
+"""
 
 from collections.abc import Iterable
 from contextlib import contextmanager

lib/iris/common/metadata.py

@@ -3,6 +3,11 @@
 # This file is part of Iris and is released under the LGPL license.
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
+"""
+Provides the infrastructure to support the common metadata API.
+
+"""
+
 
 from abc import ABCMeta
 from collections import namedtuple

lib/iris/common/mixin.py

@@ -3,15 +3,17 @@
 # This file is part of Iris and is released under the LGPL license.
 # See COPYING and COPYING.LESSER in the root of the repository for full
 # licensing details.
+"""
+Provides common metadata mixin behaviour.
 
+"""
 
 from collections.abc import Mapping
 from functools import wraps
-import re
 
 import cf_units
 
-from iris.common import BaseMetadata
+from .metadata import BaseMetadata
 import iris.std_names