diff --git a/crates/aura-std/src/lincomb.rs b/crates/aura-std/src/lincomb.rs
index 6d4849f..8134016 100644
--- a/crates/aura-std/src/lincomb.rs
+++ b/crates/aura-std/src/lincomb.rs
@@ -1,13 +1,18 @@
 //! `LinComb` — weighted sum of `N` f64 inputs (`Σ weights[i] · input[i]`), the
 //! general combinator for the north-star "combine signals with weights" move
 //! (C10). `LinComb([1.0, 1.0])` is `Add`; `LinComb([1.0, -1.0])` is `Sub`. The
-//! weights are the node's tunable parameters (C8/C12) and fix its arity.
+//! weights are construction parameters that configure the node and fix its
+//! arity (`weights.len()` inputs) — the natural home for the combination tuning
+//! params, though the schema-level tunable-param surface (C12/C19) is not yet
+//! implemented: the node contract deliberately keeps params out of the schema
+//! for now (see aura_core's node contract and spec 0002's "Out of scope").
 
 use aura_core::{Ctx, FieldSpec, Firing, InputSpec, Node, NodeSchema, Scalar, ScalarKind};
 
-/// Weighted sum of `N` f64 inputs: `Σ weights[i] · input[i]`. The `weights`
-/// are the node's tunable parameters and fix its arity (`weights.len()` inputs,
-/// in slot order). Emits `None` until *all* inputs have a value.
+/// Weighted sum of `N` f64 inputs: `Σ weights[i] · input[i]`. The `weights` are
+/// construction parameters that configure the node and fix its arity
+/// (`weights.len()` inputs, in slot order). Emits `None` until *all* inputs
+/// have a value.
 pub struct LinComb {
     weights: Vec<f64>,
     out: [Scalar; 1],