docs: add working-with-solvers notebook for the stateful Solver API#685

Draft

FBumann wants to merge 36 commits into

docs/working-with-solvers

Commits on May 11, 2026

docs: silence HiGHS console output in tutorial notebooks

FBumann
and
claude
committed
docs: silence HiGHS console output in piecewise tutorials too

FBumann
and
claude
committed

Commits on May 13, 2026

Merge remote-tracking branch 'origin/master' into docs/silence-solver-logs
FBumann
committed
docs: fix broken toctree, refresh API reference, and clean up references

FBumann
and
claude
committed
docs: reorganize toctree into basic→advanced sections and rewrite user-guide landing page

FBumann
and
claude
committed
docs: fix broken admonitions in notebooks and configure intersphinx

FBumann
and
claude
committed
docs: downgrade coordinate-determination admonition from important to note

FBumann
and
claude
committed
Revert "docs: downgrade coordinate-determination admonition from important to note"

FBumann
and
claude
committed
ci: empty commit to retrigger CI

FBumann
and
claude
committed
docs: rename toctree captions and reorder Examples below Solving

FBumann
and
claude
committed
docs: move Examples directly under User Guide

FBumann
and
claude
committed
docs: bridge Getting Started → User Guide and rename landing page H1

FBumann
and
claude
committed
docs: fix malformed first cell of solve-on-remote notebook

FBumann
and
claude
committed
docs: use markdown links for cross-refs in notebook markdown cells

FBumann
and
claude
committed
docs: collapse "Where to next" to a single pointer at the User Guide overview

FBumann
and
claude
committed
docs: restructure api.rst — task-oriented top, classes under the hood, advanced bottom

FBumann
and
claude
committed
docs: add docstrings for properties surfaced in api.rst autosummary tables

FBumann
and
claude
committed
docs: surface PWL_METHOD / PWL_CONVEXITY type aliases in api.rst

FBumann
and
claude
committed
docs: dissolve the api.rst Advanced umbrella; each item gets a natural home

FBumann
and
claude
committed
docs: keep page TOC depth 2; expand right-side TOC to L2 site-wide

FBumann
and
claude
committed
docs: rename "Classes and types" → "Other classes and types"

FBumann
and
claude
committed
docs: standardise H3 subgroup vocabulary across api.rst class sections

FBumann
and
claude
committed
docs: revert show_toc_level=2 in book-theme options

FBumann
and
claude
committed
docs: restructure api.rst as Model-first and tighten the curated surface

FBumann
and
claude
committed
docs: move piecewise construction helpers into the Piecewise section

FBumann
and
claude
committed
docs: harmonise Variables container labels with Variable; fix preamble cross-refs

FBumann
and
claude
committed

Commits on May 18, 2026