docs(ai): clear documentation-verify advisories in output-widget docs

alex-spataru · claude · alex-spataru · commit 8a7ee959187e · 2026-06-08T09:16:19.000-04:00
Convert definition-list em-dashes to colons to drop em-dash density below
threshold, and replace a "see below" rot reference with a section link.
Rebuild the AI search index.

Co-Authored-By: Claude Opus 4.8 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/app/rcc/ai/docs/output_widget_js.md b/app/rcc/ai/docs/output_widget_js.md
@@ -1,4 +1,4 @@
-# Output Widgets — JavaScript "transmit function" API
+# Output Widgets: JavaScript "transmit function" API
 
 Output widgets (Pro) translate UI state into bytes the device receives.
 Each widget instance has one user-authored JS function that runs on every
@@ -28,9 +28,9 @@ function transmit(value) {
 
 Return either:
 
-- a **String** — encoded using the widget's configured TX encoding and sent,
-- a **byte array** (`Uint8Array` or `Array<number>`) — sent verbatim,
-- `null` / `undefined` / an empty result — nothing is sent.
+- a **String**: encoded using the widget's configured TX encoding and sent,
+- a **byte array** (`Uint8Array` or `Array<number>`): sent verbatim,
+- `null` / `undefined` / an empty result: nothing is sent.
 
 There is a maximum payload size; oversized returns are dropped with an error.
 
diff --git a/app/rcc/ai/search_index.json b/app/rcc/ai/search_index.json
diff --git a/app/rcc/ai/skills/output_widgets.md b/app/rcc/ai/skills/output_widgets.md
@@ -6,8 +6,9 @@ the device. Each one belongs to a group and has its own JavaScript
 
 **Output transmit functions are JavaScript-only** — the Lua-first
 guidance in the `frame_parsers` and `transforms` skills does NOT apply
-here. A small set of Modbus/CAN protocol helpers is JS-bound (see below);
-author transmit functions in JS, Lua will not compile.
+here. A small set of Modbus/CAN protocol helpers is JS-bound
+(see [The transmit function](#the-transmit-function)); author transmit
+functions in JS, Lua will not compile.
 
 ## Five widget types
 
@@ -32,10 +33,10 @@ project.outputWidget.get{groupId, widgetId}    // read current config
 
 Each widget has:
 
-- `title`, `icon` — UI labels
-- `minValue`, `maxValue`, `stepSize`, `initialValue` — numeric range
+- `title`, `icon`: UI labels
+- `minValue`, `maxValue`, `stepSize`, `initialValue`: numeric range
   (sliders, knobs)
-- `transmitFunction` — JS source that returns the bytes to send
+- `transmitFunction`: JS source that returns the bytes to send
 
 ## The transmit function
 
