diff --git a/crates/weksa/src/context.rs b/crates/weksa/src/context.rs index 7ae7cc8..877c974 100644 --- a/crates/weksa/src/context.rs +++ b/crates/weksa/src/context.rs @@ -258,10 +258,12 @@ impl<'cp> EncoderOffer<'cp> { /// What the editor is told of how its last edit fared: whether it was kept, and /// the held-out composite at the current inventory of each panel language, -/// rounded to the nearest [`LADDER_STEP`]. A head composite changes only when an -/// edit is accepted and an accept needs a gain above one step, so a run releases -/// at most `1 / LADDER_STEP` distinct values per language (Blum and Hardt 2015, -/// the Ladder). Nothing else about the held-out split is a field. +/// rounded to the nearest [`LADDER_STEP`]. The heads change only when an edit is +/// accepted, and an accept raises the panel's composite sum by more than one +/// step, so a run over `L` languages releases at most `1.5 * L / LADDER_STEP` +/// changes of this line (Blum and Hardt 2015, the Ladder; ruling +/// `weksa-lowering:ruling:panel-accept-sum-rule`). Nothing else about the +/// held-out split is a field. /// /// ``` /// let f = weksa::context::EditFeedback::none(); diff --git a/crates/weksa/src/run.rs b/crates/weksa/src/run.rs index db29b42..a1b879d 100644 --- a/crates/weksa/src/run.rs +++ b/crates/weksa/src/run.rs @@ -67,10 +67,12 @@ pub const PROMPT_SOURCE_DIGEST: u64 = fnv1a64_of(&[ ]); /// The least composite gain an edit must show over item noise to be kept, and -/// the grid the editor's one held-out number is rounded to. A run releases at -/// most `1 / LADDER_STEP` = 200 distinct head composites (the Ladder, Blum and -/// Hardt 2015), because the head changes only on an accept and an accept needs -/// a gain above one step. +/// the grid the editor's one held-out number is rounded to. Every accept raises +/// the panel's composite sum by more than one step and a composite lies in +/// -0.5 to 1, so a run over `L` languages accepts, and changes the released +/// heads, at most `1.5 * L / LADDER_STEP` times (`300` for one language; the +/// Ladder, Blum and Hardt 2015; ruling +/// `weksa-lowering:ruling:panel-accept-sum-rule`, see [`decide_panel`]). pub const LADDER_STEP: f64 = 0.005; /// What a run pinned at open. Key `run: