Merge pull request #504 from control-toolbox/503-doc-remove-tutorials

Remove tutorials

Author: ocots

docs/Project.toml

@@ -1,48 +1,34 @@
 [deps]
-BenchmarkTools = "6e4b80f9-dd63-53aa-95a3-0cdb28fa8baf"
 CTBase = "54762871-cc72-4466-b8e8-f6c8b58076cd"
 CTDirect = "790bbbee-bee9-49ee-8912-a9de031322d5"
 CTFlows = "1c39547c-7794-42f7-af83-d98194f657c2"
 CTModels = "34c4fa32-2049-4079-8329-de33c2a22e2d"
 CTParser = "32681960-a1b1-40db-9bff-a1ca817385d1"
-CommonSolve = "38540f10-b2f7-11e9-35d8-d573e4eb0ff2"
-DifferentiationInterface = "a0c0ee7d-e4b9-4e03-894e-1c5f64a51d63"
 Documenter = "e30172f5-a6a5-5a46-863b-614d45cd2de4"
 DocumenterMermaid = "a078cd44-4d9c-4618-b545-3ab9d77f9177"
-ForwardDiff = "f6369f11-7733-5829-9624-2563aa707210"
 JLD2 = "033835bb-8acc-5ee8-8aae-3f567f8a3819"
 JSON3 = "0f8b85d8-7281-11e9-16c2-39a750bddbf1"
 LinearAlgebra = "37e2e46d-f89d-539d-b4ee-838fcccc9c8e"
-MINPACK = "4854310b-de5a-5eb6-a2a5-c1dee2bd17f9"
 MadNLP = "2621e9c9-9eb4-46b1-8089-e8c72242dfb6"
 NLPModelsIpopt = "f4238b75-b362-5c4c-b852-0801c9a21d71"
-NonlinearSolve = "8913a72c-1f9b-4ce2-8d82-65094dcecaec"
 OrdinaryDiffEq = "1dea7af3-3e70-54e6-95c3-0bf5283fa5ed"
-Percival = "01435c0c-c90d-11e9-3788-63660f8fbccc"
 Plots = "91a5bcdd-55d7-5caf-9e0b-520d859cae80"
 Suppressor = "fd094767-a336-5f1f-9728-57cf17d0bbfb"
 
 [compat]
-BenchmarkTools = "1.6"
 CTBase = "0.16"
 CTDirect = "0.14"
 CTFlows = "0.8"
 CTModels = "0.3"
 CTParser = "0.2"
-CommonSolve = "0.2"
-DifferentiationInterface = "0.6"
 Documenter = "1.8"
 DocumenterMermaid = "0.2"
-ForwardDiff = "0.10"
 JLD2 = "0.5"
 JSON3 = "1.14"
 LinearAlgebra = "1"
-MINPACK = "1.3"
 MadNLP = "0.8"
 NLPModelsIpopt = "0.10"
-NonlinearSolve = "4.6"
 OrdinaryDiffEq = "6.93"
-Percival = "0.7"
 Plots = "1.40"
 Suppressor = "0.2"
 julia = "1"

docs/make.jl

@@ -21,7 +21,7 @@ makedocs(;
     sitename="OptimalControl.jl",
     format=Documenter.HTML(;
         repolink="https://" * repo_url,
-        prettyurls=true,
+        prettyurls=false,
         size_threshold_ignore=[
             "api-ctbase/types.md", "dev-ctmodels.md", "tutorial-plot.md"
         ],
@@ -43,15 +43,6 @@ makedocs(;
             "Plot a solution" => "tutorial-plot.md",
             "Compute flows" => "tutorial-flow.md",
         ],
-        "Tutorials and Advanced Features" => [
-            "Discrete continuation" => "tutorial-continuation.md",
-            "Discretisation methods" => "tutorial-discretisation.md",
-            "NLP manipulations" => "tutorial-nlp.md",
-            "Indirect simple shooting" => "tutorial-iss.md",
-            "Goddard: direct, indirect" => "tutorial-goddard.md",
-            "Linear–quadratic regulator" => "tutorial-lqr-basic.md",
-            "Minimal action" => "tutorial-mam.md",
-        ],
         "Developers" => [
             "OptimalControl.jl" => "dev-optimalcontrol.md",
             "Subpackages" => [

docs/src/assets/Goddard_and_Rocket.jpg

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [CTBase.jl](control-toolbox.org/CTBase.jl/) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [CTBase.jl](https://github.com/control-toolbox/CTBase.jl/) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/assets/ct-repl-95x30.gif

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [CTDirect.jl](control-toolbox.org/CTDirect.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [CTDirect.jl](https://github.com/control-toolbox/CTDirect.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/assets/ct-repl-95x60.gif

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [CTFlows.jl](control-toolbox.org/CTFlows.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [CTFlows.jl](https://github.com/control-toolbox/CTFlows.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/assets/repl.mp4

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [CTModels.jl](control-toolbox.org/CTModels.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [CTModels.jl](https://github.com/control-toolbox/CTModels.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/dev-ctbase.md

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [CTParser.jl](control-toolbox.org/CTParser.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [CTParser.jl](https://github.com/control-toolbox/CTParser.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/dev-ctdirect.md

@@ -4,7 +4,7 @@
 CollapsedDocStrings = false
 ```
 
-The [OptimalControl.jl](https://control-toolbox.org/OptimalControl.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
+The [OptimalControl.jl](https://github.com/control-toolbox/OptimalControl.jl) package is part of the [control-toolbox ecosystem](https://github.com/control-toolbox).
 
 ```mermaid
 flowchart TD

docs/src/dev-ctflows.md

@@ -30,8 +30,8 @@ plus boundary conditions, control and state constraints
 
 ## OptimalControl.jl for trajectory optimisation
 
-- [Basic example](tutorial-double-integrator-energy.html)
-- [Goddard problem](tutorial-goddard.html)
+- [Basic example](@ref tutorial-double-integrator-energy)
+- [Goddard problem](https://control-toolbox.org/Tutorials.jl/stable/tutorial-goddard/)
 - [Orbit transfer](https://control-toolbox.org/Kepler.jl)
 
 ## Wrap up
@@ -58,8 +58,8 @@ plus boundary conditions, control and state constraints
 ## Credits (not exhaustive!)
 
 - [ADNLPModels.jl](https://jso.dev/ADNLPModels.jl)
-- [DifferentiationInterface.jl](https://gdalle.github.io/DifferentiationInterface.jl/DifferentiationInterface/stable)
-- [DifferentialEquations.jl](https://github.com/SciML/DifferentialEquations.jl)
+- [DifferentiationInterface.jl](https://juliadiff.org/DifferentiationInterface.jl/DifferentiationInterface)
+- [DifferentialEquations.jl](https://docs.sciml.ai/DiffEqDocs)
 - [MLStyle.jl](https://thautwarm.github.io/MLStyle.jl)
 
 ## Acknowledgements

docs/src/dev-ctmodels.md

@@ -4,7 +4,7 @@ The full grammar of [OptimalControl.jl](https://control-toolbox.org/OptimalContr
 - pure Julia (and, as such, effortlessly analysed by the standard Julia parser),
 - as close as possible to the mathematical description of an optimal control problem. 
 
-While the syntax will be transparent to those users familiar with Julia expressions (`Expr`'s), we provide examples for every case that should be widely understandable. We rely heavily on [MLStyle.jl](https://github.com/thautwarm/MLStyle.jl) and its pattern matching abilities 👍🏽 for the semantic pass. Abstract definitions use the macro `@def`.
+While the syntax will be transparent to those users familiar with Julia expressions (`Expr`'s), we provide examples for every case that should be widely understandable. We rely heavily on [MLStyle.jl](https://thautwarm.github.io/MLStyle.jl) and its pattern matching abilities 👍🏽 for the semantic pass. Abstract definitions use the macro `@def`.
 
 ## [Variable](@id tutorial-abstract-variable)
 
@@ -77,7 +77,7 @@ tf = 5
 end
 ```
 
-One (or even the two bounds) can be variable, typically for minimum time problems (see [Mayer cost](#mayer) section):
+One (or even the two bounds) can be variable, typically for minimum time problems (see [Mayer cost](@ref tutorial-abstract-mayer) section):
 
 ```julia
 @def begin
@@ -208,7 +208,7 @@ F₁(x) = [0, 1]
 !!! note
     The vector fields `F₀` and `F₁` can be defined afterwards, as they only need to be available when the dynamics will be evaluated.
 
-Currently, it is not possible to declare the dynamics component after component, but a simple workaround is to use *aliases* (check the relevant [aliases](#aliases) section below):
+Currently, it is not possible to declare the dynamics component after component, but a simple workaround is to use *aliases* (check the relevant [aliases](@ref tutorial-abstract-aliases) section below):
 
 ```julia
 @def damped_integrator begin
@@ -471,7 +471,7 @@ end
 :( $a = $e1 )
 ```
 
-The single `=` symbol is used to define not a constraint but an alias, that is a purely syntactic replacement. There are some automatic aliases, *e.g.* `x₁` for `x[1]` if `x` is the state, and we have also seen that the user can define her own aliases when declaring the [variable](#variable), [state](#state) and [control](#control). Arbitrary aliases can be further defined, as below (compare with previous examples in the [dynamics](#dynamics) section):
+The single `=` symbol is used to define not a constraint but an alias, that is a purely syntactic replacement. There are some automatic aliases, *e.g.* `x₁` for `x[1]` if `x` is the state, and we have also seen that the user can define her own aliases when declaring the [variable](@ref tutorial-abstract-variable), [state](@ref tutorial-abstract-state) and [control](@ref tutorial-abstract-control). Arbitrary aliases can be further defined, as below (compare with previous examples in the [dynamics](@ref tutorial-abstract-dynamics) section):
 
 ```julia
 @def begin