Docs: ignore numpydoc validation checks (#1310)

.gitignore

@@ -62,6 +62,8 @@ doc/*.ipynb
 doc/*/*.ipynb
 doc/*.rst
 doc/*/*.rst
+builtdocs/
+jupyter_execute/
 
 # PyBuilder
 target/

doc/conf.py

@@ -66,5 +66,26 @@
 
 nbbuild_cell_timeout = 2000
 
+# Datashader uses sphinx.ext.autodoc (e.g. automodule) for its API reference
+# and automatically include a module that contains Image. Image inherits
+# from xr.DataArray. Datashader uses numpydoc to parse the docstrings.
+# It turns out xarray broke numpydoc https://github.com/pydata/xarray/issues/8596
+# This is a bad hack to work around this issue.
+
+import numpydoc.docscrape  # noqa
+
+original_error_location = numpydoc.docscrape.NumpyDocString._error_location
+
+def patch_error_location(self, msg, error=True):
+    try:
+        original_error_location(self, msg, error)
+    except ValueError as e:
+        if "See Also entry ':doc:`xarray-tutorial" in str(e):
+            return
+        else:
+            raise e
+
+numpydoc.docscrape.NumpyDocString._error_location = patch_error_location
+
 # Override the Sphinx default title that appends `documentation`
 html_title = f'{project} v{version}'