Cap ModelingToolkit to v9 to fix docs build under MTK v11#64
Merged
ChrisRackauckas merged 1 commit intoJun 21, 2026
Merged
Conversation
The dependabot bump in SciML#62 widened compat to allow ModelingToolkit v11.26 (and ForwardDiff 1.4, Sundials 6.2, DataInterpolations 8.10, DifferentialEquations 8.0, OrdinaryDiffEq 7.0, Symbolics 7.26), which resolved ModelingToolkit v11.26.8. MTK v11 is a major breaking release that moved the modeling DSL out of ModelingToolkit: `@mtkmodel` and `@connector` now require SciCompDSL.jl, and `missing_variable_defaults` and `defaults` were removed. The course lecture `@example` blocks are written against the MTK v9 DSL, so the Documentation build failed across lecture1/2/6/8 with `@mtkmodel`/`@connector`/`missing_variable_defaults` UndefVarErrors and a `NewtonRaphson not defined` error (the latter from DifferentialEquations v8 no longer re-exporting it). Revert the SciML#62 dependabot widening, restoring the last-known-green compat. Locally on Julia 1.11 the docs environment now resolves to ModelingToolkit 9.15.0, Symbolics 5.28.0, OrdinaryDiffEq 6.74.1, DifferentialEquations 7.13.0, Sundials 4.24.0, ForwardDiff 0.10.39, DataInterpolations 5.0.0, ModelingToolkitStandardLibrary 2.11.0 - the v9-era stack the lectures were authored against. OrdinaryDiffEq is kept pinned to =6.74.1 per the existing note in docs/make.jl. Co-Authored-By: Chris Rackauckas <accounts@chrisrackauckas.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Problem
The Documentation build on
mainis failing. The last dependabot bump (#62, "Bump the all-julia-packages group") widened compat across several deps, the critical one being:This let ModelingToolkit v11.26.8 resolve. MTK v11 is a major breaking release that moved the modeling DSL out of ModelingToolkit core:
@mtkmodeland@connectornow requireSciCompDSL.jl(To use this @connector syntax, please import SciCompDSL.jl)ModelingToolkit.missing_variable_defaultsandModelingToolkit.defaultswere removedNewtonRaphsonis no longer re-exported byDifferentialEquations(which also jumped to v8)The course lecture
@exampleblocks are written against the MTK v9 DSL, so the docs build failed acrosslecture1.md,lecture2.md,lecture6.mdandlecture8.mdwith@mtkmodel/@connector/missing_variable_defaults/defaultsUndefVarErrors.Fix
Revert the #62 dependabot widening, restoring the last-known-green compat (cap ModelingToolkit back to
"9"and the other coupled deps to their pre-bump bounds). This is a compat-cap fix; no lecture content is changed.Local verification
On Julia 1.11 (the version the Documentation workflow pins),
Pkg.resolve()of thedocsenvironment now selects the v9-era stack the lectures were authored against:With MTK 9.15.0 the removed/moved APIs (
@mtkmodel,@connector,missing_variable_defaults,defaults) are all present again, and DifferentialEquations 7.13.0 re-exportsNewtonRaphson. OrdinaryDiffEq stays pinned at=6.74.1per the existing note indocs/make.jl.Please ignore until reviewed by @ChrisRackauckas