CI: Disable unavoidable Documenter errors

Author: eschnett

docs/Project.toml

@@ -4,6 +4,6 @@ MPI = "da04e1cc-30fd-572f-bb4f-1f8673147195"
 MPIPreferences = "3da0fdf6-3ccc-4f1b-acd9-58baa6c99267"
 
 [compat]
-Documenter = "1.7 - 1.15"
+Documenter = "1.7"
 MPIPreferences = "0.1"
 MPI = "0.20"

docs/make.jl

@@ -77,6 +77,12 @@ makedocs(
             "reference/api.md",
         ],
         "refindex.md",
+        # - Our cross references contain paths that begin with `..`.
+        #   Documenter does not like this. We know this, and we
+        #   disable this check until we fixed this.
+        # - The link checks do not work on CI because the web sites to
+        #   which we point forbid access to our CI systems (403).
+        warnonly = [:cross_references, :linkcheck],
     ],
     # Run linkcheck tests only on CI, to speed up building of documentation locally.  If one
     # wants to run the linkchecks locally they can set the environment variable `CI=true`.