diff --git a/module/processor/patterndetectorprocessor/config.go b/module/processor/patterndetectorprocessor/config.go
index 2524aa5a..8c20e50a 100644
--- a/module/processor/patterndetectorprocessor/config.go
+++ b/module/processor/patterndetectorprocessor/config.go
@@ -1,5 +1,13 @@
 // SPDX-License-Identifier: Apache-2.0
 
+// Knob naming convention:
+//   - New per-pattern knobs MUST use the prefixed form: <Pattern><Knob>
+//     (e.g. CheckpointerHangBackwardWindow, DataLoaderHangStallThreshold).
+//   - Bare names (NCCLHangThreshold, XidCorrelationWindow, HBMECCWindow,
+//     ThermalThrottleWindow, PCIeAERWindow, IBLinkFlapWindow,
+//     CUDAOOMCorrelationWindow, JoinWindow) exist for backward-compat with
+//     pre-v0.4 values.yaml; do not rename in v1.0-rc1.
+//   - v2.0 may nest into per-pattern blocks (see issue #379).
 package patterndetectorprocessor
 
 import (