DOC: Add sphinx doc, initial commit

python-control · KybernetikJo · Jul 26, 2023 · Jul 26, 2023 · Jul 26, 2023 · Jul 26, 2023
commit a99afe1dbde6e30424521a0d0efd2e2a4db12c91
diff --git a/doc/Makefile b/doc/Makefile
@@ -0,0 +1,20 @@
+# Minimal makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line, and also
+# from the environment for the first two.
+SPHINXOPTS    ?=
+SPHINXBUILD   ?= sphinx-build
+SOURCEDIR     = .
+BUILDDIR      = _build
+
+# Put it first so that "make" without argument is like "make help".
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+.PHONY: help Makefile
+
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
diff --git a/doc/_build/doctrees/environment.pickle b/doc/_build/doctrees/environment.pickle
diff --git a/doc/_build/doctrees/index.doctree b/doc/_build/doctrees/index.doctree
diff --git a/doc/_build/doctrees/intro.doctree b/doc/_build/doctrees/intro.doctree
diff --git a/doc/_build/doctrees/nbsphinx/source/dev/inspect_slycot.ipynb b/doc/_build/doctrees/nbsphinx/source/dev/inspect_slycot.ipynb
diff --git a/doc/_build/doctrees/nbsphinx/source_dev_inspect_slycot_13_0.png b/doc/_build/doctrees/nbsphinx/source_dev_inspect_slycot_13_0.png
diff --git a/doc/_build/doctrees/source/dev/basic.doctree b/doc/_build/doctrees/source/dev/basic.doctree
diff --git a/doc/_build/doctrees/source/dev/index.doctree b/doc/_build/doctrees/source/dev/index.doctree
diff --git a/doc/_build/doctrees/source/dev/inspect_slycot.doctree b/doc/_build/doctrees/source/dev/inspect_slycot.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab01nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab01nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab04md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab04md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab05md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab05md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab05nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab05nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab07nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab07nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab08nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab08nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab08nz.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab08nz.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09ax.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09ax.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab09nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13dd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13dd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13ed.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13ed.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13fd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13fd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.ab13md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03rd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03rd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03vd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03vd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03vy.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03vy.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03wd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb03wd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb05md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb05md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb05nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mb05nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mc01td.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.mc01td.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb01bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb01bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb02md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb02md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb03md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb03md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb03od.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb03od.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb04md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb04md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb04qd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb04qd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10dd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10dd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10fd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10fd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10hd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sb10hd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sg03ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sg03ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sg03bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.sg03bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tb01id.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tb01id.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tb01pd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tb01pd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tf01md.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tf01md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tf01rd.doctree b/doc/_build/doctrees/source/reference/generated/slycot._wrapper.tf01rd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab01nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab01nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab04md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab04md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab05md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab05md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab05nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab05nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab07nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab07nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab08nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab08nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab08nz.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab08nz.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab09ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab09ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab09ax.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab09ax.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab09bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab09bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab09md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab09md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab09nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab09nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab13bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab13bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab13dd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab13dd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab13ed.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab13ed.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab13fd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab13fd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.ab13md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.ab13md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb03rd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb03rd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb03vd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb03vd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb03vy.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb03vy.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb03wd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb03wd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb05md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb05md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mb05nd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mb05nd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.mc01td.doctree b/doc/_build/doctrees/source/reference/generated/slycot.mc01td.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb01bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb01bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb02md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb02md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb02mt.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb02mt.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb02od.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb02od.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb03md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb03md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb03md57.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb03md57.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb03od.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb03od.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb04md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb04md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb04qd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb04qd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb10ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb10ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb10dd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb10dd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb10fd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb10fd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sb10hd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sb10hd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sg02ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sg02ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sg03ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sg03ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.sg03bd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.sg03bd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tb01id.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tb01id.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tb01pd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tb01pd.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tb03ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tb03ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tb04ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tb04ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tb05ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tb05ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tc01od.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tc01od.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tc04ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tc04ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.td04ad.doctree b/doc/_build/doctrees/source/reference/generated/slycot.td04ad.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tf01md.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tf01md.doctree
diff --git a/doc/_build/doctrees/source/reference/generated/slycot.tf01rd.doctree b/doc/_build/doctrees/source/reference/generated/slycot.tf01rd.doctree
diff --git a/doc/_build/doctrees/source/reference/index.doctree b/doc/_build/doctrees/source/reference/index.doctree
diff --git a/doc/_build/doctrees/source/reference/slycot_inner.doctree b/doc/_build/doctrees/source/reference/slycot_inner.doctree
diff --git a/doc/_build/doctrees/source/reference/slycot_outer.doctree b/doc/_build/doctrees/source/reference/slycot_outer.doctree
diff --git a/doc/_build/html/.buildinfo b/doc/_build/html/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 59b0ef15c44f238dfc51bd39a66aeba3
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/doc/_build/html/_images/math/06a8f1b6c9ddbe9f1821a9da07839c9decbe4136.png b/doc/_build/html/_images/math/06a8f1b6c9ddbe9f1821a9da07839c9decbe4136.png
diff --git a/doc/_build/html/_images/math/0e6e570fe40eb33ee23358ea87ca766ee9edbbb6.png b/doc/_build/html/_images/math/0e6e570fe40eb33ee23358ea87ca766ee9edbbb6.png
diff --git a/doc/_build/html/_images/math/62298e4eb211e0edc5f0821df1ffd07b8362963f.png b/doc/_build/html/_images/math/62298e4eb211e0edc5f0821df1ffd07b8362963f.png
diff --git a/doc/_build/html/_images/math/87d0fb13b3e293721bca2d361611091ddff991db.png b/doc/_build/html/_images/math/87d0fb13b3e293721bca2d361611091ddff991db.png
diff --git a/doc/_build/html/_images/math/a6604bba12fd2bde0be9924269128594fa445f8d.png b/doc/_build/html/_images/math/a6604bba12fd2bde0be9924269128594fa445f8d.png
diff --git a/doc/_build/html/_images/math/c682306352d61d00dba7b0849edbe8d5a0fd2e0d.png b/doc/_build/html/_images/math/c682306352d61d00dba7b0849edbe8d5a0fd2e0d.png
diff --git a/doc/_build/html/_images/source_dev_inspect_slycot_13_0.png b/doc/_build/html/_images/source_dev_inspect_slycot_13_0.png
diff --git a/doc/_build/html/_sources/index.rst.txt b/doc/_build/html/_sources/index.rst.txt
@@ -0,0 +1,40 @@
+.. slycot documentation master file, created by
+   sphinx-quickstart on Wed Jul 26 15:18:00 2023.
+   You can adapt this file completely to your liking, but it should at least
+   contain the root `toctree` directive.
+
+Slycot
+======
+
+Python wrapper for selected SLICOT routines, 
+notably including solvers for Riccati, Lyapunov, and Sylvester equations.
+
+.. rubric:: Features
+
+- Analysis Routines
+- Benchmark
+- Adaptive Control
+- Data Analysis
+- Filtering
+- Identification
+- Mathematical Routines
+- Nonlinear Systems
+- Synthesis Routines
+- Transformation Routines
+- Utility Routines
+
+.. rubric:: Documentation
+
+.. toctree::
+   :maxdepth: 1
+
+   intro
+   source/reference/index
+   source/dev/index
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`
diff --git a/doc/_build/html/_sources/intro.rst.txt b/doc/_build/html/_sources/intro.rst.txt
@@ -0,0 +1,59 @@
+************
+Introduction
+************
+
+Welcome to the Slycot (`slycot`) User's Manual. 
+This manual contains information on using the `slycot` package, 
+including documentation for all functions in the package and examples illustrating their use.
+
+Installation
+============
+
+The `slycot` package can be installed using conda or pip.  The
+package requires `NumPy <http://www.numpy.org>`_.
+
+For users with the Anaconda distribution of Python, the following
+command can be used::
+
+  conda install -c conda-forge slycot
+
+This installs `slycot` from conda-forge, including the
+`openblas` package.  NumPy will also be installed if
+they are not already present.
+
+.. note::
+   Mixing packages from conda-forge and the default conda channel
+   can sometimes cause problems with dependencies, so it is usually best to
+   instally NumPy, SciPy, and Matplotlib from conda-forge as well.
+
+To install using pip::
+
+  pip install slycot
+
+.. note::
+   If you install Slycot using pip you'll need a development
+   environment (e.g., Python development files, C and Fortran compilers).
+   Pip installation can be particularly complicated for Windows.
+
+Users can check to insure that slycot is installed 
+correctly by running the command::
+
+  python -c "import slycot"
+
+and verifying that no error message appears. More information on the 
+Slycot package can be obtained from the `Slycot project page
+<https://github.com/python-control/Slycot>`_.
+
+Alternatively, to install from source, first `download the source
+<https://github.com/python-control/Slycot>`_ and unpack it.
+To install in your home directory, use::
+
+    pip install .
+
+Getting started
+===============
+
+There are two different ways to use the package.  For the default interface
+described in :ref:`function-ref`, simply import the control package as follows::
+
+    >>> import slycot
diff --git a/doc/_build/html/_sources/source/dev/basic.rst.txt b/doc/_build/html/_sources/source/dev/basic.rst.txt
@@ -0,0 +1,140 @@
+**********************
+Contributing to Slycot
+**********************
+
+F2PY
+====
+Slycot heavily relias on `F2PY <https://numpy.org/devdocs/f2py/index.html>`_.
+`F2PY`_ is currently a part of `NumPy <http://www.numpy.org>`_.
+
+Development process - summary
+=============================
+
+Here's the short summary, complete TOC links are below:
+
+1. If you are a first-time contributor:
+
+   * Go to `https://github.com/numpy/numpy
+     <https://github.com/numpy/numpy>`_ and click the
+     "fork" button to create your own copy of the project.
+
+   * Clone the project to your local computer::
+
+      git clone --recurse-submodules https://github.com/your-username/numpy.git
+
+   * Change the directory::
+
+      cd numpy
+
+   * Add the upstream repository::
+
+      git remote add upstream https://github.com/numpy/numpy.git
+
+   * Now, ``git remote -v`` will show two remote repositories named:
+
+     - ``upstream``, which refers to the ``numpy`` repository
+     - ``origin``, which refers to your personal fork
+
+   * Pull the latest changes from upstream, including tags::
+
+      git checkout main
+      git pull upstream main --tags
+
+   * Initialize numpy's submodules::
+
+      git submodule update --init
+
+2. Develop your contribution:
+
+   * Create a branch for the feature you want to work on. Since the
+     branch name will appear in the merge message, use a sensible name
+     such as 'linspace-speedups'::
+
+      git checkout -b linspace-speedups
+
+   * Commit locally as you progress (``git add`` and ``git commit``)
+     Use a :ref:`properly formatted<writing-the-commit-message>` commit message,
+     write tests that fail before your change and pass afterward, run all the
+     :ref:`tests locally<development-environment>`. Be sure to document any
+     changed behavior in docstrings, keeping to the NumPy docstring
+     :ref:`standard<howto-document>`.
+
+3. To submit your contribution:
+
+   * Push your changes back to your fork on GitHub::
+
+      git push origin linspace-speedups
+
+   * Enter your GitHub username and password (repeat contributors or advanced
+     users can remove this step by connecting to GitHub with
+     :ref:`SSH<set-up-and-configure-a-github-account>`).
+
+   * Go to GitHub. The new branch will show up with a green Pull Request
+     button. Make sure the title and message are clear, concise, and self-
+     explanatory. Then click the button to submit it.
+
+   * If your commit introduces a new feature or changes functionality, post on
+     the `mailing list`_ to explain your changes. For bug fixes, documentation
+     updates, etc., this is generally not necessary, though if you do not get
+     any reaction, do feel free to ask for review.
+
+4. Review process:
+
+   * Reviewers (the other developers and interested community members) will
+     write inline and/or general comments on your Pull Request (PR) to help
+     you improve its implementation, documentation and style.  Every single
+     developer working on the project has their code reviewed, and we've come
+     to see it as friendly conversation from which we all learn and the
+     overall code quality benefits.  Therefore, please don't let the review
+     discourage you from contributing: its only aim is to improve the quality
+     of project, not to criticize (we are, after all, very grateful for the
+     time you're donating!). See our :ref:`Reviewer Guidelines
+     <reviewer-guidelines>` for more information.
+
+   * To update your PR, make your changes on your local repository, commit,
+     **run tests, and only if they succeed** push to your fork. As soon as
+     those changes are pushed up (to the same branch as before) the PR will
+     update automatically. If you have no idea how to fix the test failures,
+     you may push your changes anyway and ask for help in a PR comment.
+
+   * Various continuous integration (CI) services are triggered after each PR
+     update to build the code, run unit tests, measure code coverage and check
+     coding style of your branch. The CI tests must pass before your PR can be
+     merged. If CI fails, you can find out why by clicking on the "failed"
+     icon (red cross) and inspecting the build and test log. To avoid overuse
+     and waste of this resource,
+     :ref:`test your work<recommended-development-setup>` locally before
+     committing.
+
+   * A PR must be **approved** by at least one core team member before merging.
+     Approval means the core team member has carefully reviewed the changes,
+     and the PR is ready for merging.
+
+5. Document changes
+
+   Beyond changes to a functions docstring and possible description in the
+   general documentation, if your change introduces any user-facing
+   modifications they may need to be mentioned in the release notes.
+   To add your change to the release notes, you need to create a short file
+   with a summary and place it in ``doc/release/upcoming_changes``.
+   The file ``doc/release/upcoming_changes/README.rst`` details the format and
+   filename conventions.
+
+   If your change introduces a deprecation, make sure to discuss this first on
+   GitHub or the mailing list first. If agreement on the deprecation is
+   reached, follow :ref:`NEP 23 deprecation policy <NEP23>`  to add the deprecation.
+
+6. Cross referencing issues
+
+   If the PR relates to any issues, you can add the text ``xref gh-xxxx`` where
+   ``xxxx`` is the number of the issue to github comments. Likewise, if the PR
+   solves an issue, replace the ``xref`` with ``closes``, ``fixes`` or any of
+   the other flavors `github accepts <https://help.github.com/en/articles/
+   closing-issues-using-keywords>`_.
+
+   In the source code, be sure to preface any issue or PR reference with
+   ``gh-xxxx``.
+
+For a more detailed discussion, read on and follow the links at the bottom of
+this page.
+
diff --git a/doc/_build/html/_sources/source/dev/index.rst.txt b/doc/_build/html/_sources/source/dev/index.rst.txt
@@ -0,0 +1,10 @@
+******************
+Development
+******************
+
+.. toctree::
+   :maxdepth: 1
+
+   basic
+   inspect_slycot
+