Polishing

Author: timmens

docs/source/algorithms.md

@@ -5,15 +5,15 @@
 Check out {ref}`how-to-select-algorithms` to see how to select an algorithm and specify
 `algo_options` when using `maximize` or `minimize`.
 
-## Optimizers from scipy
+## Optimizers from SciPy
 
 (scipy-algorithms)=
 
 optimagic supports most [SciPy](https://scipy.org/) algorithms and SciPy is
 automatically installed when you install optimagic.
 
 ```{eval-rst}
-.. dropdown::  ``scipy_lbfgsb``
+.. dropdown::  scipy_lbfgsb
 
     **How to use this algorithm:**
 

docs/source/conf.py

@@ -158,7 +158,7 @@
     todo_emit_warnings = True
 
 # -- Options for myst-nb  ----------------------------------------
-nb_execution_mode = "off"  # "off", "force", "cache", "auto"
+nb_execution_mode = "force"  # "off", "force", "cache", "auto"
 nb_execution_allow_errors = False
 nb_merge_streams = True
 

docs/source/explanation/internal_optimizers.md

@@ -98,7 +98,9 @@ To make switching between different algorithm as simple as possible, we align th
 of commonly used convergence and stopping criteria. We also align the default values for
 stopping and convergence criteria as much as possible.
 
-You can find the harmonized names and value [here](algo_options_docs).
+```{eval-rst}
+You can find the harmonized names and value here: :ref:`algo_options`.
+```
 
 To align the names of other tuning parameters as much as possible with what is already
 there, simple have a look at the optimizers we already wrapped. For example, if you are

docs/source/reference/algo_options.md

@@ -1,4 +1,4 @@
-(algo_options_docs)=
+(algo_options)=
 
 # The default algorithm options