diff --git a/docs/conf.py b/docs/conf.py
index 1c1ca11..fa5dc8b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -336,3 +336,6 @@
 
 # Autodoc configuraton.
 autoclass_content = 'both'
+
+# remove exceptions related to built-in python types (see https://bugs.python.org/issue11975)
+nitpick_ignore = [('py:obj', 'list')]
diff --git a/tests/helpers.py b/tests/helpers.py
index da58f1f..8c83650 100644
--- a/tests/helpers.py
+++ b/tests/helpers.py
@@ -27,7 +27,6 @@
 from jsonresolver import JSONResolver
 from jsonresolver.contrib.jsonref import json_loader_factory
 
-
 LOADER_CLS = json_loader_factory(JSONResolver(
     plugins=['invenio_jsonschemas.jsonresolver']
 ))