docs(ad): polish Lux example comments + retrigger Doc CI#444
Closed
ChrisRackauckas-Claude wants to merge 1 commit into
Closed
Conversation
Slight wording tweaks in `docs/src/examples/ad.md`: - Tightened the comment describing the tiny Lux model so it reads more clearly as "trainable parameters become the two ODE parameters (a Dense(1=>2) over a constant input)". - Annotated the `Random.seed!` call with a `# reproducibility` hint so readers don't have to guess why the seed is set. Doubles as a minimal-diff trigger for a fresh Doc CI run on `master` now that the Lux ↔ MLDataDevices ↔ RecursiveArrayTools v4 resolution conflict is unblocked upstream — the previous "CUDA Tests & Docs" run on master HEAD is still red from the 2026-04-30 build, before that fix landed in the registry. Verified locally that the docs environment now resolves cleanly (MLDataDevices 1.17.10, RecursiveArrayTools 4.3.0, Lux 1.31.4, Optimisers 0.4.7, Zygote 0.7.10) and the training loop in the example trains end-to-end on CPU via EnsembleSerial. Co-Authored-By: Chris Rackauckas <accounts@chrisrackauckas.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
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.
Note: Please ignore this PR until reviewed by @ChrisRackauckas. Opening as a draft.
Summary
Tiny wording tweak to the Lux/AD example in
docs/src/examples/ad.md:Dense(1 => 2)model.# reproducibilityhint next to theRandom.seed!call.Why a follow-up PR
PR #442 (Flux → Lux + Optimisers + Zygote) was merged on 2026-04-30
with a failing Documentation CI run. The failure was a package
resolution error, not anything in the example code:
Lux 1.xrequiredMLDataDevices ≤ 1.17.8, butRecursiveArrayTools v4(pinned by DiffEqGPU) needed a newer
MLDataDevices. As of this weekthat's been unblocked upstream —
MLDataDevices 1.17.10resolvescleanly with
RecursiveArrayTools 4.3.0andLux 1.31.4.This PR exists primarily to retrigger the Doc CI on a current
registry snapshot now that the resolver conflict is gone.
Test plan
Pkg.instantiateondocs/Project.tomlresolves locally withthe post-unblock registry — 81 deps precompile cleanly.
(
EnsembleSerial):