Fix documentation building (#1217)

* Fix documentation building

* Fix numpy version

* Fix two links

Author: mfeurer

.github/workflows/docs.yaml

@@ -13,6 +13,9 @@ jobs:
     - name: Install dependencies
       run: |
         pip install -e .[docs,examples,examples_unix]
+        # dependency "fanova" does not work with numpy 1.24 or later
+        # https://github.com/automl/fanova/issues/108
+        pip install numpy==1.23.5
     - name: Make docs
       run: |
         cd doc

doc/contributing.rst

@@ -23,6 +23,6 @@ In particular, a few ways to contribute to openml-python are:
 
  * `Cite OpenML <https://www.openml.org/cite>`_ if you use it in a scientific publication.
 
- * Visit one of our `hackathons <https://meet.openml.org/>`_.
+ * Visit one of our `hackathons <https://www.openml.org/meet>`_.
 
  * Contribute to another OpenML project, such as `the main OpenML project <https://github.com/openml/OpenML/blob/master/CONTRIBUTING.md>`_.

doc/index.rst

@@ -40,7 +40,7 @@ Example
     run.publish()
     print(f'View the run online: {run.openml_url}')
 
-You can find more examples in our :ref:`sphx_glr_examples`.
+You can find more examples in our :ref:`examples-index`.
 
 ----------------------------
 How to get OpenML for python
@@ -60,7 +60,7 @@ Content
 
 * :ref:`usage`
 * :ref:`api`
-* :ref:`sphx_glr_examples`
+* :ref:`examples-index`
 * :ref:`extensions`
 * :ref:`contributing`
 * :ref:`progress`

examples/30_extended/fetch_evaluations_tutorial.py

@@ -90,9 +90,9 @@ def plot_cdf(values, metric="predictive_accuracy"):
     plt.title("CDF")
     plt.xlabel(metric)
     plt.ylabel("Likelihood")
-    plt.grid(b=True, which="major", linestyle="-")
+    plt.grid(visible=True, which="major", linestyle="-")
     plt.minorticks_on()
-    plt.grid(b=True, which="minor", linestyle="--")
+    plt.grid(visible=True, which="minor", linestyle="--")
     plt.axvline(max_val, linestyle="--", color="gray")
     plt.text(max_val, 0, "%.3f" % max_val, fontsize=9)
     plt.show()

examples/30_extended/fetch_runtimes_tutorial.py

@@ -408,7 +408,7 @@ def get_incumbent_trace(trace):
 ################################################################################
 # Running a Neural Network from scikit-learn that uses scikit-learn independent
 # parallelism using libraries such as `MKL, OpenBLAS or BLIS
-# <https://scikit-learn.org/stable/computing/parallelism.html#parallel-numpy-routines-from-numerical-libraries>`_.
+# <https://scikit-learn.org/stable/computing/parallelism.html#parallel-numpy-and-scipy-routines-from-numerical-libraries>`_.
 
 mlp = MLPClassifier(max_iter=10)
 

examples/README.txt

@@ -1,3 +1,5 @@
+.. _examples-index:
+
 ================
 Examples Gallery
 ================