#3534, #3536: docs: the Warp Stabilizer and Roto Brush keys come from analysis::frames_key

crates/engine/src/analysis/roto.rs

@@ -8,8 +8,8 @@
 //! (`Renderer::layer_input`, source → masks → the effects above it). `roto.freeze` runs the same
 //! pass and stores the final mattes in the effect (one undo step). `sync`, run after every
 //! edit, keeps each instance's hidden Input Key equal to a signature of what its frames are made
-//! of (the layer's source and timing, its masks and the effects above it) and drops frozen
-//! mattes made from other frames.
+//! of (the layer's source and timing, its masks and the effects above it: `analysis::frames_key`),
+//! and drops frozen mattes made from other frames. Footage going offline keeps them.
 //!
 //! Object Matte instances run through the same jobs (`objectMatte.propagate` / `.freeze`): the
 //! frames are [`om::job_frames`] around the reference frame, each segmented through

crates/engine/src/analysis/warp.rs

@@ -6,10 +6,11 @@
 //! analyzer (step 1 of 2, "Analyzing in background"); step 2 ("Stabilizing") derives the
 //! stabilization plan once to validate and cache the result. When the job finishes, the analysis is
 //! written into the effect's hidden Analysis parameter as one undo step, together with a key of
-//! what it was made from (the layer's source, In/Out, start, stretch and Time Remap). Edits that
-//! change those clear the analysis (`invalidate`, run after every edit) and queue the effect
-//! for re-analysis, which frontends start with [`Session::poll_warp`] (After Effects re-analyses
-//! automatically too).
+//! what it was made from (the layer's source, In/Out, start, stretch and Time Remap; the key is
+//! `analysis::frames_key`'s, shared with the 3D Camera Tracker and Roto Brush). Edits that change
+//! those clear the analysis (`invalidate`, run after every edit) and queue the effect for
+//! re-analysis, which frontends start with [`Session::poll_warp`] (After Effects re-analyses
+//! automatically too). Footage going offline is not such a change.
 
 use crate::offload::{JobKind, rate};
 use std::sync::atomic::{AtomicBool, Ordering};