Merge branch 'doc-reorg' of https://github.com/Pyomo/pyomo into doc-r…

…eorg
Pyomo · Aug 23, 2024 · 4fc015e · 4fc015e
2 parents 7f18f37 + ac48ed5
commit 4fc015e
Show file tree

Hide file tree

Showing 119 changed files with 22 additions and 67 deletions.
diff --git a/doc/OnlineDocs/_static/theme_overrides.css b/doc/OnlineDocs/_static/theme_overrides.css
@@ -31,6 +31,10 @@ dl.py.method dt em span.n {
   }
 }
 
+.rst-content table.docutils td {
+  vertical-align: top;
+}
+
 /* Remove space after tables in definition lists (e.g., for function
    "Parameters" lists*/
 .rst-content dl div.wy-table-responsive {

diff --git a/doc/OnlineDocs/index.rst b/doc/OnlineDocs/index.rst
@@ -10,6 +10,7 @@ with a diverse set of optimization capabilities.
 
 
 .. list-table::
+   :width: 100%
    :class: index-table
 
    * - Getting Started
@@ -61,8 +62,7 @@ with a diverse set of optimization capabilities.
      - Reference Guide
          | :doc:`Library Reference <reference_guide/index>`
          | :doc:`Common Warnings and Errors`
-         | :doc:`Related Packages`
-         | :doc:`Preview capabilities through ``pyomo.__future__```
+         | :doc:`Preview capabilities through ``pyomo.__future__`` <developer_guide/future>`
 
 .. toctree::
    :hidden:
@@ -90,6 +90,22 @@ Ask a question on StackOverflow using the `#pyomo` tag:
 
 * https://stackoverflow.com/questions/ask?tags=pyomo 
 
+Additional Pyomo tutorials and examples can be found at the following links:
+
+* `Pyomo — Optimization Modeling in Python
+  <https://link.springer.com/book/10.1007/978-3-030-68928-5>`_ ([PyomoBookIII]_)
+
+* `Pyomo Workshop Slides and Exercises
+  <https://github.com/Pyomo/pyomo-tutorials>`_
+
+* `Prof. Jeffrey Kantor's Pyomo Cookbook
+  <https://jckantor.github.io/ND-Pyomo-Cookbook/>`_
+
+* The `companion notebooks <https://mobook.github.io/MO-book/intro.html>`_
+  for *Hands-On Mathematical Optimization with Python*
+
+* `Pyomo Gallery <https://github.com/Pyomo/PyomoGallery>`_
+
 
 Contributing to Pyomo
 ---------------------

diff --git a/...ibuted_packages/alternative_solutions.rst → ...ations/analysis/alternative_solutions.rst b/...ibuted_packages/alternative_solutions.rst → ...ations/analysis/alternative_solutions.rst
diff --git a/.../contributed_packages/communities_8pp.png → ...explanations/analysis/communities_8pp.png b/.../contributed_packages/communities_8pp.png → ...explanations/analysis/communities_8pp.png
diff --git a/...ributed_packages/communities_decode_1.png → ...nations/analysis/communities_decode_1.png b/...ributed_packages/communities_decode_1.png → ...nations/analysis/communities_decode_1.png
diff --git a/..._guide/contributed_packages/community.rst → .../user_explanations/analysis/community.rst b/..._guide/contributed_packages/community.rst → .../user_explanations/analysis/community.rst
diff --git a/...contributed_packages/doe/CCSI-license.txt → ...xplanations/analysis/doe/CCSI-license.txt b/...contributed_packages/doe/CCSI-license.txt → ...xplanations/analysis/doe/CCSI-license.txt
diff --git a/...tributed_packages/doe/FIM_sensitivity.png → ...anations/analysis/doe/FIM_sensitivity.png b/...tributed_packages/doe/FIM_sensitivity.png → ...anations/analysis/doe/FIM_sensitivity.png
diff --git a/...er_guide/contributed_packages/doe/doe.rst → ...cs/user_explanations/analysis/doe/doe.rst b/...er_guide/contributed_packages/doe/doe.rst → ...cs/user_explanations/analysis/doe/doe.rst
diff --git a/...de/contributed_packages/doe/flowchart.png → ...r_explanations/analysis/doe/flowchart.png b/...de/contributed_packages/doe/flowchart.png → ...r_explanations/analysis/doe/flowchart.png
diff --git a/...guide/contributed_packages/doe/grid-1.png → ...user_explanations/analysis/doe/grid-1.png b/...guide/contributed_packages/doe/grid-1.png → ...user_explanations/analysis/doe/grid-1.png
diff --git a/...uide/contributed_packages/doe/reactor.png → ...ser_explanations/analysis/doe/reactor.png b/...uide/contributed_packages/doe/reactor.png → ...ser_explanations/analysis/doe/reactor.png
diff --git a/...er_guide/contributed_packages/doe/uml.png → ...cs/user_explanations/analysis/doe/uml.png b/...er_guide/contributed_packages/doe/uml.png → ...cs/user_explanations/analysis/doe/uml.png
diff --git a/...s/user_guide/contributed_packages/iis.rst → ...neDocs/user_explanations/analysis/iis.rst b/...s/user_guide/contributed_packages/iis.rst → ...neDocs/user_explanations/analysis/iis.rst
diff --git a/...de/contributed_packages/incidence/api.rst → ...r_explanations/analysis/incidence/api.rst b/...de/contributed_packages/incidence/api.rst → ...r_explanations/analysis/incidence/api.rst
diff --git a/...contributed_packages/incidence/config.rst → ...xplanations/analysis/incidence/config.rst b/...contributed_packages/incidence/config.rst → ...xplanations/analysis/incidence/config.rst
diff --git a/...tributed_packages/incidence/connected.rst → ...anations/analysis/incidence/connected.rst b/...tributed_packages/incidence/connected.rst → ...anations/analysis/incidence/connected.rst
diff --git a/...packages/incidence/dulmage_mendelsohn.rst → ...analysis/incidence/dulmage_mendelsohn.rst b/...packages/incidence/dulmage_mendelsohn.rst → ...analysis/incidence/dulmage_mendelsohn.rst
diff --git a/...tributed_packages/incidence/incidence.rst → ...anations/analysis/incidence/incidence.rst b/...tributed_packages/incidence/incidence.rst → ...anations/analysis/incidence/incidence.rst
diff --git a/.../contributed_packages/incidence/index.rst → ...explanations/analysis/incidence/index.rst b/.../contributed_packages/incidence/index.rst → ...explanations/analysis/incidence/index.rst
diff --git a/...tributed_packages/incidence/interface.rst → ...anations/analysis/incidence/interface.rst b/...tributed_packages/incidence/interface.rst → ...anations/analysis/incidence/interface.rst
diff --git a/...ntributed_packages/incidence/matching.rst → ...lanations/analysis/incidence/matching.rst b/...ntributed_packages/incidence/matching.rst → ...lanations/analysis/incidence/matching.rst
diff --git a/...ntributed_packages/incidence/overview.rst → ...lanations/analysis/incidence/overview.rst b/...ntributed_packages/incidence/overview.rst → ...lanations/analysis/incidence/overview.rst
diff --git a/...ributed_packages/incidence/scc_solver.rst → ...nations/analysis/incidence/scc_solver.rst b/...ributed_packages/incidence/scc_solver.rst → ...nations/analysis/incidence/scc_solver.rst
diff --git a/...uted_packages/incidence/triangularize.rst → ...ions/analysis/incidence/triangularize.rst b/...uted_packages/incidence/triangularize.rst → ...ions/analysis/incidence/triangularize.rst
diff --git a/...ibuted_packages/incidence/tutorial.bt.rst → ...ations/analysis/incidence/tutorial.bt.rst b/...ibuted_packages/incidence/tutorial.bt.rst → ...ations/analysis/incidence/tutorial.bt.rst
diff --git a/...d_packages/incidence/tutorial.btsolve.rst → ...s/analysis/incidence/tutorial.btsolve.rst b/...d_packages/incidence/tutorial.btsolve.rst → ...s/analysis/incidence/tutorial.btsolve.rst
diff --git a/...ibuted_packages/incidence/tutorial.dm.rst → ...ations/analysis/incidence/tutorial.dm.rst b/...ibuted_packages/incidence/tutorial.dm.rst → ...ations/analysis/incidence/tutorial.dm.rst
diff --git a/...ntributed_packages/incidence/tutorial.rst → ...lanations/analysis/incidence/tutorial.rst b/...ntributed_packages/incidence/tutorial.rst → ...lanations/analysis/incidence/tutorial.rst
diff --git a/...er_guide/contributed_packages/mpc/api.rst → ...cs/user_explanations/analysis/mpc/api.rst b/...er_guide/contributed_packages/mpc/api.rst → ...cs/user_explanations/analysis/mpc/api.rst
diff --git a/...e/contributed_packages/mpc/conversion.rst → ..._explanations/analysis/mpc/conversion.rst b/...e/contributed_packages/mpc/conversion.rst → ..._explanations/analysis/mpc/conversion.rst
diff --git a/...r_guide/contributed_packages/mpc/data.rst → ...s/user_explanations/analysis/mpc/data.rst b/...r_guide/contributed_packages/mpc/data.rst → ...s/user_explanations/analysis/mpc/data.rst
diff --git a/...ide/contributed_packages/mpc/examples.rst → ...er_explanations/analysis/mpc/examples.rst b/...ide/contributed_packages/mpc/examples.rst → ...er_explanations/analysis/mpc/examples.rst
diff --git a/...er_guide/contributed_packages/mpc/faq.rst → ...cs/user_explanations/analysis/mpc/faq.rst b/...er_guide/contributed_packages/mpc/faq.rst → ...cs/user_explanations/analysis/mpc/faq.rst
diff --git a/..._guide/contributed_packages/mpc/index.rst → .../user_explanations/analysis/mpc/index.rst b/..._guide/contributed_packages/mpc/index.rst → .../user_explanations/analysis/mpc/index.rst
diff --git a/...de/contributed_packages/mpc/interface.rst → ...r_explanations/analysis/mpc/interface.rst b/...de/contributed_packages/mpc/interface.rst → ...r_explanations/analysis/mpc/interface.rst
diff --git a/...ide/contributed_packages/mpc/modeling.rst → ...er_explanations/analysis/mpc/modeling.rst b/...ide/contributed_packages/mpc/modeling.rst → ...er_explanations/analysis/mpc/modeling.rst
diff --git a/...ide/contributed_packages/mpc/overview.rst → ...er_explanations/analysis/mpc/overview.rst b/...ide/contributed_packages/mpc/overview.rst → ...er_explanations/analysis/mpc/overview.rst
diff --git a/...uide/contributed_packages/parmest/api.rst → ...ser_explanations/analysis/parmest/api.rst b/...uide/contributed_packages/parmest/api.rst → ...ser_explanations/analysis/parmest/api.rst
diff --git a/.../contributed_packages/parmest/boxplot.png → ...explanations/analysis/parmest/boxplot.png b/.../contributed_packages/parmest/boxplot.png → ...explanations/analysis/parmest/boxplot.png
diff --git a/...ntributed_packages/parmest/covariance.rst → ...lanations/analysis/parmest/covariance.rst b/...ntributed_packages/parmest/covariance.rst → ...lanations/analysis/parmest/covariance.rst
diff --git a/.../contributed_packages/parmest/datarec.rst → ...explanations/analysis/parmest/datarec.rst b/.../contributed_packages/parmest/datarec.rst → ...explanations/analysis/parmest/datarec.rst
diff --git a/...e/contributed_packages/parmest/driver.rst → ..._explanations/analysis/parmest/driver.rst b/...e/contributed_packages/parmest/driver.rst → ..._explanations/analysis/parmest/driver.rst
diff --git a/...contributed_packages/parmest/examples.rst → ...xplanations/analysis/parmest/examples.rst b/...contributed_packages/parmest/examples.rst → ...xplanations/analysis/parmest/examples.rst
diff --git a/...contributed_packages/parmest/graphics.rst → ...xplanations/analysis/parmest/graphics.rst b/...contributed_packages/parmest/graphics.rst → ...xplanations/analysis/parmest/graphics.rst
diff --git a/...de/contributed_packages/parmest/index.rst → ...r_explanations/analysis/parmest/index.rst b/...de/contributed_packages/parmest/index.rst → ...r_explanations/analysis/parmest/index.rst
diff --git a/...ributed_packages/parmest/installation.rst → ...nations/analysis/parmest/installation.rst b/...ributed_packages/parmest/installation.rst → ...nations/analysis/parmest/installation.rst
diff --git a/...contributed_packages/parmest/overview.rst → ...xplanations/analysis/parmest/overview.rst b/...contributed_packages/parmest/overview.rst → ...xplanations/analysis/parmest/overview.rst
diff --git a/...ted_packages/parmest/pairwise_plot_CI.png → ...ons/analysis/parmest/pairwise_plot_CI.png b/...ted_packages/parmest/pairwise_plot_CI.png → ...ons/analysis/parmest/pairwise_plot_CI.png
diff --git a/...ted_packages/parmest/pairwise_plot_LR.png → ...ons/analysis/parmest/pairwise_plot_LR.png b/...ted_packages/parmest/pairwise_plot_LR.png → ...ons/analysis/parmest/pairwise_plot_LR.png
diff --git a/...contributed_packages/parmest/parallel.rst → ...xplanations/analysis/parmest/parallel.rst b/...contributed_packages/parmest/parallel.rst → ...xplanations/analysis/parmest/parallel.rst
diff --git a/...ntributed_packages/parmest/scencreate.rst → ...lanations/analysis/parmest/scencreate.rst b/...ntributed_packages/parmest/scencreate.rst → ...lanations/analysis/parmest/scencreate.rst
diff --git a/...tributed_packages/sensitivity_toolbox.rst → ...anations/analysis/sensitivity_toolbox.rst b/...tributed_packages/sensitivity_toolbox.rst → ...anations/analysis/sensitivity_toolbox.rst
diff --git a/...user_guide/contributed_packages/index.rst → ...eDocs/user_explanations/contrib_index.rst b/...user_guide/contributed_packages/index.rst → ...eDocs/user_explanations/contrib_index.rst
diff --git a/doc/OnlineDocs/user_guide/index.rst → doc/OnlineDocs/user_explanations/index.rst b/doc/OnlineDocs/user_guide/index.rst → doc/OnlineDocs/user_explanations/index.rst
diff --git a/...pyomo_modeling_components/Constraints.rst → ...ser_explanations/modeling/Constraints.rst b/...pyomo_modeling_components/Constraints.rst → ...ser_explanations/modeling/Constraints.rst
diff --git a/...pyomo_modeling_components/Expressions.rst → ...ser_explanations/modeling/Expressions.rst b/...pyomo_modeling_components/Expressions.rst → ...ser_explanations/modeling/Expressions.rst
diff --git a/.../pyomo_modeling_components/Objectives.rst → ...user_explanations/modeling/Objectives.rst b/.../pyomo_modeling_components/Objectives.rst → ...user_explanations/modeling/Objectives.rst
diff --git a/.../pyomo_modeling_components/Parameters.rst → ...user_explanations/modeling/Parameters.rst b/.../pyomo_modeling_components/Parameters.rst → ...user_explanations/modeling/Parameters.rst
diff --git a/..._guide/pyomo_modeling_components/Sets.rst → ...eDocs/user_explanations/modeling/Sets.rst b/..._guide/pyomo_modeling_components/Sets.rst → ...eDocs/user_explanations/modeling/Sets.rst
diff --git a/...de/pyomo_modeling_components/Suffixes.rst → ...s/user_explanations/modeling/Suffixes.rst b/...de/pyomo_modeling_components/Suffixes.rst → ...s/user_explanations/modeling/Suffixes.rst
diff --git a/...e/pyomo_modeling_components/Variables.rst → .../user_explanations/modeling/Variables.rst b/...e/pyomo_modeling_components/Variables.rst → .../user_explanations/modeling/Variables.rst
diff --git a/...cs/user_guide/modeling_extensions/dae.rst → ...neDocs/user_explanations/modeling/dae.rst b/...cs/user_guide/modeling_extensions/dae.rst → ...neDocs/user_explanations/modeling/dae.rst
diff --git a/...uide/modeling_extensions/gdp/concepts.rst → ...er_explanations/modeling/gdp/concepts.rst b/...uide/modeling_extensions/gdp/concepts.rst → ...er_explanations/modeling/gdp/concepts.rst
diff --git a/...r_guide/modeling_extensions/gdp/index.rst → .../user_explanations/modeling/gdp/index.rst b/...r_guide/modeling_extensions/gdp/index.rst → .../user_explanations/modeling/gdp/index.rst
diff --git a/...uide/modeling_extensions/gdp/modeling.rst → ...er_explanations/modeling/gdp/modeling.rst b/...uide/modeling_extensions/gdp/modeling.rst → ...er_explanations/modeling/gdp/modeling.rst
diff --git a/...guide/modeling_extensions/gdp/solving.rst → ...ser_explanations/modeling/gdp/solving.rst b/...guide/modeling_extensions/gdp/solving.rst → ...ser_explanations/modeling/gdp/solving.rst
diff --git a/...guide/pyomo_modeling_components/index.rst → ...Docs/user_explanations/modeling/index.rst b/...guide/pyomo_modeling_components/index.rst → ...Docs/user_explanations/modeling/index.rst
diff --git a/...s/user_guide/modeling_extensions/mpec.rst → ...eDocs/user_explanations/modeling/mpec.rst b/...s/user_guide/modeling_extensions/mpec.rst → ...eDocs/user_explanations/modeling/mpec.rst
diff --git a/...ser_guide/modeling_extensions/network.rst → ...cs/user_explanations/modeling/network.rst b/...ser_guide/modeling_extensions/network.rst → ...cs/user_explanations/modeling/network.rst
diff --git a/...odeling_extensions/reduce_points_demo.png → ...lanations/modeling/reduce_points_demo.png b/...odeling_extensions/reduce_points_demo.png → ...lanations/modeling/reduce_points_demo.png
diff --git a/...OnlineDocs/user_guide/sos_constraints.rst → ...explanations/modeling/sos_constraints.rst b/...OnlineDocs/user_guide/sos_constraints.rst → ...explanations/modeling/sos_constraints.rst
diff --git a/...OnlineDocs/user_guide/units_container.rst → ...explanations/modeling/units_container.rst b/...OnlineDocs/user_guide/units_container.rst → ...explanations/modeling/units_container.rst
diff --git a/...OnlineDocs/user_guide/flattener/index.rst → ...ns/modeling_utilities/flattener/index.rst b/...OnlineDocs/user_guide/flattener/index.rst → ...ns/modeling_utilities/flattener/index.rst
diff --git a/...eDocs/user_guide/flattener/motivation.rst → ...deling_utilities/flattener/motivation.rst b/...eDocs/user_guide/flattener/motivation.rst → ...deling_utilities/flattener/motivation.rst
diff --git a/...neDocs/user_guide/flattener/reference.rst → ...odeling_utilities/flattener/reference.rst b/...neDocs/user_guide/flattener/reference.rst → ...odeling_utilities/flattener/reference.rst
diff --git a/...de/contributed_packages/latex_printer.rst → ...ions/modeling_utilities/latex_printer.rst b/...de/contributed_packages/latex_printer.rst → ...ions/modeling_utilities/latex_printer.rst
diff --git a/...de/contributed_packages/preprocessing.rst → ...ions/modeling_utilities/preprocessing.rst b/...de/contributed_packages/preprocessing.rst → ...ions/modeling_utilities/preprocessing.rst
diff --git a/doc/OnlineDocs/user_guide/scaling.rst → ...planations/modeling_utilities/scaling.rst b/doc/OnlineDocs/user_guide/scaling.rst → ...planations/modeling_utilities/scaling.rst
diff --git a/...ser_guide/contributed_packages/gdpopt.rst → ...Docs/user_explanations/solvers/gdpopt.rst b/...ser_guide/contributed_packages/gdpopt.rst → ...Docs/user_explanations/solvers/gdpopt.rst
diff --git a/...contributed_packages/gdpopt_flowchart.png → ...explanations/solvers/gdpopt_flowchart.png b/...contributed_packages/gdpopt_flowchart.png → ...explanations/solvers/gdpopt_flowchart.png
diff --git a/.../user_guide/contributed_packages/mcpp.rst → ...neDocs/user_explanations/solvers/mcpp.rst b/.../user_guide/contributed_packages/mcpp.rst → ...neDocs/user_explanations/solvers/mcpp.rst
diff --git a/...er_guide/contributed_packages/mindtpy.rst → ...ocs/user_explanations/solvers/mindtpy.rst b/...er_guide/contributed_packages/mindtpy.rst → ...ocs/user_explanations/solvers/mindtpy.rst
diff --git a/...guide/contributed_packages/multistart.rst → .../user_explanations/solvers/multistart.rst b/...guide/contributed_packages/multistart.rst → .../user_explanations/solvers/multistart.rst
diff --git a/...ineDocs/user_guide/persistent_solvers.rst → ...planations/solvers/persistent_solvers.rst b/...ineDocs/user_guide/persistent_solvers.rst → ...planations/solvers/persistent_solvers.rst
diff --git a/...ide/contributed_packages/pynumero/api.rst → ...ser_explanations/solvers/pynumero/api.rst b/...ide/contributed_packages/pynumero/api.rst → ...ser_explanations/solvers/pynumero/api.rst
diff --git a/...kages/pynumero/backward_compatibility.rst → ...lvers/pynumero/backward_compatibility.rst b/...kages/pynumero/backward_compatibility.rst → ...lvers/pynumero/backward_compatibility.rst
diff --git a/...e/contributed_packages/pynumero/index.rst → ...r_explanations/solvers/pynumero/index.rst b/...e/contributed_packages/pynumero/index.rst → ...r_explanations/solvers/pynumero/index.rst
diff --git a/...ibuted_packages/pynumero/installation.rst → ...nations/solvers/pynumero/installation.rst b/...ibuted_packages/pynumero/installation.rst → ...nations/solvers/pynumero/installation.rst
diff --git a/...pynumero/pynumero.interfaces.ampl_nlp.rst → ...pynumero/pynumero.interfaces.ampl_nlp.rst b/...pynumero/pynumero.interfaces.ampl_nlp.rst → ...pynumero/pynumero.interfaces.ampl_nlp.rst
diff --git a/.../pynumero/pynumero.interfaces.asl_nlp.rst → .../pynumero/pynumero.interfaces.asl_nlp.rst b/.../pynumero/pynumero.interfaces.asl_nlp.rst → .../pynumero/pynumero.interfaces.asl_nlp.rst
diff --git a/...mero/pynumero.interfaces.extended_nlp.rst → ...mero/pynumero.interfaces.extended_nlp.rst b/...mero/pynumero.interfaces.extended_nlp.rst → ...mero/pynumero.interfaces.extended_nlp.rst
diff --git a/...ro.interfaces.external_grey_box_model.rst → ...ro.interfaces.external_grey_box_model.rst b/...ro.interfaces.external_grey_box_model.rst → ...ro.interfaces.external_grey_box_model.rst
diff --git a/...ages/pynumero/pynumero.interfaces.nlp.rst → ...vers/pynumero/pynumero.interfaces.nlp.rst b/...ages/pynumero/pynumero.interfaces.nlp.rst → ...vers/pynumero/pynumero.interfaces.nlp.rst
diff --git a/...ero/pynumero.interfaces.projected_nlp.rst → ...ero/pynumero.interfaces.projected_nlp.rst b/...ero/pynumero.interfaces.projected_nlp.rst → ...ero/pynumero.interfaces.projected_nlp.rst
diff --git a/...ynumero.interfaces.pyomo_grey_box_nlp.rst → ...ynumero.interfaces.pyomo_grey_box_nlp.rst b/...ynumero.interfaces.pyomo_grey_box_nlp.rst → ...ynumero.interfaces.pyomo_grey_box_nlp.rst
diff --git a/...ynumero/pynumero.interfaces.pyomo_nlp.rst → ...ynumero/pynumero.interfaces.pyomo_nlp.rst b/...ynumero/pynumero.interfaces.pyomo_nlp.rst → ...ynumero/pynumero.interfaces.pyomo_nlp.rst
diff --git a/...packages/pynumero/pynumero.interfaces.rst → .../solvers/pynumero/pynumero.interfaces.rst b/...packages/pynumero/pynumero.interfaces.rst → .../solvers/pynumero/pynumero.interfaces.rst
diff --git a/...ackages/pynumero/pynumero.linalg.base.rst → ...solvers/pynumero/pynumero.linalg.base.rst b/...ackages/pynumero/pynumero.linalg.base.rst → ...solvers/pynumero/pynumero.linalg.base.rst
diff --git a/...ackages/pynumero/pynumero.linalg.ma27.rst → ...solvers/pynumero/pynumero.linalg.ma27.rst b/...ackages/pynumero/pynumero.linalg.ma27.rst → ...solvers/pynumero/pynumero.linalg.ma27.rst
diff --git a/...ackages/pynumero/pynumero.linalg.ma57.rst → ...solvers/pynumero/pynumero.linalg.ma57.rst b/...ackages/pynumero/pynumero.linalg.ma57.rst → ...solvers/pynumero/pynumero.linalg.ma57.rst
diff --git a/...ckages/pynumero/pynumero.linalg.mumps.rst → ...olvers/pynumero/pynumero.linalg.mumps.rst b/...ckages/pynumero/pynumero.linalg.mumps.rst → ...olvers/pynumero/pynumero.linalg.mumps.rst
diff --git a/...ted_packages/pynumero/pynumero.linalg.rst → ...ions/solvers/pynumero/pynumero.linalg.rst b/...ted_packages/pynumero/pynumero.linalg.rst → ...ions/solvers/pynumero/pynumero.linalg.rst
diff --git a/...ckages/pynumero/pynumero.linalg.scipy.rst → ...olvers/pynumero/pynumero.linalg.scipy.rst b/...ckages/pynumero/pynumero.linalg.scipy.rst → ...olvers/pynumero/pynumero.linalg.scipy.rst
diff --git a/...pynumero/pynumero.sparse.block_vector.rst → ...pynumero/pynumero.sparse.block_vector.rst b/...pynumero/pynumero.sparse.block_vector.rst → ...pynumero/pynumero.sparse.block_vector.rst
diff --git a/...ted_packages/pynumero/pynumero.sparse.rst → ...ions/solvers/pynumero/pynumero.sparse.rst b/...ted_packages/pynumero/pynumero.sparse.rst → ...ions/solvers/pynumero/pynumero.sparse.rst
diff --git a/...o/tutorial.block_vectors_and_matrices.rst → ...o/tutorial.block_vectors_and_matrices.rst b/...o/tutorial.block_vectors_and_matrices.rst → ...o/tutorial.block_vectors_and_matrices.rst
diff --git a/...ero/tutorial.linear_solver_interfaces.rst → ...ero/tutorial.linear_solver_interfaces.rst b/...ero/tutorial.linear_solver_interfaces.rst → ...ero/tutorial.linear_solver_interfaces.rst
diff --git a/...packages/pynumero/tutorial.mpi_blocks.rst → .../solvers/pynumero/tutorial.mpi_blocks.rst b/...packages/pynumero/tutorial.mpi_blocks.rst → .../solvers/pynumero/tutorial.mpi_blocks.rst
diff --git a/...ages/pynumero/tutorial.nlp_interfaces.rst → ...vers/pynumero/tutorial.nlp_interfaces.rst b/...ages/pynumero/tutorial.nlp_interfaces.rst → ...vers/pynumero/tutorial.nlp_interfaces.rst
diff --git a/...ontributed_packages/pynumero/tutorial.rst → ...xplanations/solvers/pynumero/tutorial.rst b/...ontributed_packages/pynumero/tutorial.rst → ...xplanations/solvers/pynumero/tutorial.rst
diff --git a/...user_guide/contributed_packages/pyros.rst → ...eDocs/user_explanations/solvers/pyros.rst b/...user_guide/contributed_packages/pyros.rst → ...eDocs/user_explanations/solvers/pyros.rst
diff --git a/...uide/contributed_packages/trustregion.rst → ...user_explanations/solvers/trustregion.rst b/...uide/contributed_packages/trustregion.rst → ...user_explanations/solvers/trustregion.rst
diff --git a/..._guide/contributed_packages/satsolver.rst → ...ser_explanations/solvers/z3_interface.rst b/..._guide/contributed_packages/satsolver.rst → ...ser_explanations/solvers/z3_interface.rst
diff --git a/doc/OnlineDocs/user_guide/external_tutorials.rst b/doc/OnlineDocs/user_guide/external_tutorials.rst
diff --git a/doc/OnlineDocs/user_guide/modeling_extensions/__init__.py b/doc/OnlineDocs/user_guide/modeling_extensions/__init__.py
diff --git a/doc/OnlineDocs/user_guide/modeling_extensions/bilevel.rst b/doc/OnlineDocs/user_guide/modeling_extensions/bilevel.rst
diff --git a/doc/OnlineDocs/user_guide/modeling_extensions/index.rst b/doc/OnlineDocs/user_guide/modeling_extensions/index.rst
diff --git a/doc/OnlineDocs/user_guide/modeling_extensions/stochastic_programming.rst b/doc/OnlineDocs/user_guide/modeling_extensions/stochastic_programming.rst