docs(solver): update drag protocol docs to reflect implemented caching #330

forbes · 2026-02-25T19:23:56Z

forbes commented

2026-02-25 19:23:56 +00:00

The interactive drag section described the original naive implementation (re-solve from scratch each step) and called the caching layer a 'planned future optimization'. In reality _DragCache is fully implemented.

Changes

Replace stale code snippets with the actual pre_drag()/drag_step()/post_drag() implementation
Add _DragCache field table documenting the cached artifacts
Document the single_equation_pass exclusion from the drag path (context from #329)
Replace 'Performance notes' with accurate description of the caching layer

The interactive drag section described the original naive implementation (re-solve from scratch each step) and called the caching layer a 'planned future optimization'. In reality `_DragCache` is fully implemented. ## Changes - Replace stale code snippets with the actual `pre_drag()`/`drag_step()`/`post_drag()` implementation - Add `_DragCache` field table documenting the cached artifacts - Document the `single_equation_pass` exclusion from the drag path (context from #329) - Replace 'Performance notes' with accurate description of the caching layer

forbes added 1 commit 2026-02-25 19:23:56 +00:00

docs(solver): update drag protocol docs to reflect implemented caching

Build and Test / build (pull_request) Successful in 30m27s

Details

6e15b25134

The interactive drag section described the original naive implementation
(re-solve from scratch each step) and called the caching layer a
'planned future optimization'. In reality _DragCache is fully
implemented: pre_drag() builds the system, Jacobian, and compiled
evaluator once, and drag_step() reuses them.

Update code snippets, add _DragCache field table, and document the
single_equation_pass exclusion from the drag path.

forbes merged commit 3550d916bd into main

2026-02-26 14:25:21 +00:00

forbes deleted branch docs/solver-drag-cache

2026-02-26 14:25:21 +00:00

forbes referenced this issue from a commit

2026-02-26 14:25:23 +00:00

Merge pull request 'docs(solver): update drag protocol docs to reflect implemented caching' (#330) from docs/solver-drag-cache into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kindred/create#330