DOC: Add new docs requirements

doc/source/dev/core-dev/distributing.rst.inc

@@ -48,6 +48,7 @@ are:
 - `PyData Sphinx theme`_ (docs)
 - `Sphinx-Design`_  (docs)
 - matplotlib_ (docs)
+- MyST-NB_ (docs)
 
 Furthermore of course one needs C, C++ and Fortran compilers to build SciPy,
 but those we don't consider to be dependencies and are therefore not discussed
@@ -223,3 +224,4 @@ Wheelhouse_, see at the wheel_ and Wheelhouse_ docs.
 .. _decorator: https://github.com/micheles/decorator
 .. _manylinux: https://github.com/pypa/manylinux/
 .. _threadpoolctl: https://github.com/joblib/threadpoolctl
+.. _MyST-NB: https://myst-nb.readthedocs.io/

doc/source/dev/toolchain.rst

@@ -29,7 +29,9 @@ section for an example.)
 - Compilers for C, C++, Fortran code are needed, as well as for Cython & Pythran (the latter is opt-out currently)
 - The Python environment needs the ``NumPy`` package to be installed.
 - Testing requires the ``pytest`` Python package.
-- Building the documentation requires the ``matplotlib``, Sphinx packages along with PyData theme.
+- Building the documentation requires the ``matplotlib``, Sphinx and MyST-NB_ packages along with PyData theme.
+
+.. _MyST-NB: https://myst-nb.readthedocs.io/
 
 The tooling used to build CPython has some implications for the tooling used
 in building SciPy.
@@ -411,6 +413,7 @@ PyData Sphinx theme   Whatever recent versions work. >= 0.8.1.
 Sphinx-Design         Whatever recent versions work. >= 0.2.0.
 numpydoc              Whatever recent versions work. >= 0.8.0.
 matplotlib            Generally suggest >= 2.0.
+MyST-NB               Whatever recent versions work. >= 0.17.1
 ====================  =================================================
 
 .. note::

doc/source/notebooks/interp_transition_guide.md

@@ -19,13 +19,13 @@ This notebook contains three sets of demonstrations:
 - recommended replacements for `interp2d` for use in new code;
 - a demonstration of failure modes of 2D FITPACK-based linear interpolation and recommended replacements.
 
-+++ 
++++
 
 ## 1. How to transition away from using  `interp2d`
 
 `interp2d` silently switches between interpolation on a 2D regular grid and interpolatin 2D scattered data. The switch is based on the lengths of the (raveled) `x`, `y`, and `z` arrays. In short, for regular grid use `RectBivariateSpline`; for scattered interpolation, use the `bisprep/bisplev` combo. Below we give examples of the literal point-for-point transition, which should preserve the `interp2d` results exactly.
 
-+++ 
++++
 
 ### 1.1 `interp2d` on a regular grid
 

doc/source/tutorial/index.rst

@@ -9,9 +9,8 @@ SciPy User Guide
 .. sectionauthor:: Travis E. Oliphant
 
 SciPy is a collection of mathematical algorithms and convenience functions built
-on NumPy_ . It adds significant power to the interactive Python session by
-providing the user with high-level commands and classes for manipulating and
-visualizing data.
+on NumPy_ . It adds significant power to Python by providing the user with
+high-level commands and classes for manipulating and visualizing data.
 
 .. _NumPy: https://numpy.org
 
@@ -45,12 +44,6 @@ SciPy subpackages need to be imported separately, for example::
 
     >>> from scipy import linalg, optimize
 
-Because of their ubiquitousness, some of the functions in these
-subpackages are also made available in the `scipy` namespace to ease
-their use in interactive sessions and programs. In addition, many
-basic array functions from :mod:`numpy` are also available at the
-top-level of the :mod:`scipy` package.
-
 Below, you can find the complete user guide organized by subpackages.
 
 .. raw:: latex

doc_requirements.txt

@@ -5,3 +5,5 @@ pydata-sphinx-theme==0.9.0
 sphinx-design>=0.2.0
 numpydoc
 matplotlib>2
+docutils<0.18.1
+myst-nb

pyproject.toml

@@ -116,6 +116,8 @@ doc = [
     "sphinx-design>=0.2.0",
     "matplotlib>2",
     "numpydoc",
+    "docutils<0.18.1",
+    "myst-nb",
 ]
 dev = [
     "mypy",