test: make tutorial checks robust (require index.jmd and Project.toml only); docs: minor copy edits

Author: arnavk23

test/runtests.jl

@@ -5,16 +5,19 @@ function tests()
     readdir(rootdir),
   )
   for dir in dirs
-    subdirs = readdir(joinpath(rootdir, dir))
+    subdirs = filter(y -> isdir(joinpath(rootdir, dir, y)), readdir(joinpath(rootdir, dir)))
     for subdir in subdirs
-      prefix = joinpath(rootdir, dir, subdir, subdir)
+      prefix = joinpath(rootdir, dir, subdir, "index")
       println("Verifying files in $dir/$subdir")
-      for suffix in [".jmd", ".html", ".ipynb", ".jl"]
-        spc = " "^(6 - length(suffix))
-        print("  $subdir$suffix$spc exists…… ")
-        @assert isfile(prefix * suffix)
-        println("✓")
-      end
+      # Require the source markdown to be present
+      print("  index.jmd   exists…… ")
+      @assert isfile(prefix * ".jmd")
+      println("✓")
+
+      # Optional: ensure each tutorial folder has a Project.toml for deps
+      print("  Project.toml exists…… ")
+      @assert isfile(joinpath(rootdir, dir, subdir, "Project.toml"))
+      println("✓")
     end
   end
 end

tutorials/advanced-jsosolvers/index.jmd

@@ -68,8 +68,6 @@ The same subsolver selection pattern applies to TRON’s least-squares specializ
 stats_tron = tron(nls; subsolver = :lsmr, rtol = RTOL, atol = ATOL, max_time = max_time)
 ```
 
-Note on API updates: since JSOSolvers v0.11, subsolvers are selected using the keyword argument `subsolver` with a Symbol, for example `subsolver = :lsmr`. The previous form using `subsolver_type = CglsSolver` (and similar types) has been removed. The lists returned by `JSOSolvers.trunkls_allowed_subsolvers` and `JSOSolvers.tronls_allowed_subsolvers` enumerate the valid symbols you can pass.
-
 ```julia
 solvers = Dict(
     :trunk_cgls => nlp -> trunk(nlp; subsolver = :cgls),