No commit message

pyproject.toml

@@ -286,17 +286,19 @@ addopts = ["--strict-config", "--strict-markers"]
 # We want to forbid warnings from within xarray in our tests — instead we should
 # fix our own code, or mark the test itself as expecting a warning. So this:
 # - Converts any warning from xarray into an error
-# - Ignores warnings which the test suite currently raises; since it wasn't
-# - practical to fix them all before merging this config. We can remove these
-#   over time -- if you see a warning that we now handle, remove the exception.
-#   If you are up for a small contribution, find the warning and fix it! The
-#   warnings are still listed (`default`, not `ignore`).
+# - Allows some warnings ("default") which the test suite currently raises,
+#   since it wasn't practical to fix them all before merging this config. The
+#   arnings are still listed in CI (since it uses `default`, not `ignore`).
+#
+# We can remove these rules allowing warnings; a valued contribution is removing
+# a line, seeing what breaks, and then fixing the library code or tests so that
+# it doesn't raise warnings.
 #
 # While we only raise an error on warnings from within xarray, if dependency
 # raises a warning with a stacklevel such that it's interpreted to be raised
-# from xarray, please feel free to ignore it here.
+# from xarray, please feel free to add a rule switching it to `default` here.
 #
-# If this gets in the way of making progress, it's also acceptable to
+# If these settings get in the way of making progress, it's also acceptable to
 # temporarily add additional ignores.
 
 filterwarnings = [