Update class01.md

.github/workflows /documentation.yml → .github/workflows/documentation.yml

@@ -20,10 +20,10 @@ jobs:
           version: '1'
       - uses: julia-actions/cache@v2
       - name: Install dependencies
-        run: julia --project=docs/ -e 'using Pkg; Pkg.develop(PackageSpec(path=pwd())); Pkg.instantiate()'
-      - name: Setup symlink
-        run: ln -s ../../class01/class01.md class01.md
-        working-directory: docs/src
+        run: julia --project=docs/ -e 'using Pkg; Pkg.instantiate()'
+      # - name: Setup symlink
+      #   run: ln -s ../../class01/class01.md class01.md
+      #   working-directory: docs/src
       - name: Build and deploy
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

class01/class01.md

@@ -2,7 +2,7 @@
 
 **Presenter:** Andrew Rosemberg
 
-**Topic:** Course map; why PDE-constrained optimization; tooling overview; stability & state-space dynamics; Lyapunov; discretization issues
+**Topic:** Course map; why PDE-constrained optimization; tooling overview; stability & state-space dynamics; Lyapunov; discretization issues.
 
 ---
 
@@ -72,4 +72,4 @@ We have prepared a basic (Pluto) [Linear Algebra Primer](./background_materials/
 ### **Optimization**:
 We will use JuMP for some optimization tasks. If you are new to JuMP, please review the [JuMP Tutorial](https://jump.dev/JuMP.jl/stable/tutorials/getting_started/getting_started_with_JuMP/) to familiarize yourself with its syntax and capabilities.
 
-Test your knowledge with this (Pluto) [Modeling Exercise](./background_materials/optimization_homework.jl).
+Test your knowledge with this (Pluto) [Modeling Exercise](./background_materials/optimization_homework.jl).

docs/make.jl

@@ -10,6 +10,12 @@ plutos = [
     joinpath(repo_dir, "class01", "background_materials", "basics_math.jl"),
 ]
 
+if !isdir(build_dir)
+    symlink(joinpath(repo_dir, "class01"),
+        joinpath(repo_dir, "docs", "src", "class01")
+    )
+end
+
 makedocs(
     sitename = "LearningToControlClass",
     format = Documenter.HTML(;
@@ -24,10 +30,12 @@ makedocs(
     ),
     pages  = [
         "Home"   => "index.md",
-        "Class 1" => "class01.md",
+        "Class 1" => ["class01/class01.md"],
     ],
 )
 
+rm(joinpath(repo_dir, "docs", "src", "class01"), force=true)
+
 s = Pluto.ServerSession();
 for pluto in plutos
     nb = Pluto.SessionActions.open(s, pluto; run_async=false)