update

instrumentation.md

@@ -89,6 +89,34 @@ export class AppErrorBoundary extends React.Component<
 Use the same pattern in your application, including a user-visible fallback
 for individual views and the application root.
 
+## Todo widget
+
+`otel-todo.js` adds a small floating symbol and a keyboard shortcut
+(default `Alt+Shift+T`) that opens a corner dialog for filing a todo/issue
+from the page, with an optional component picker. The current path and hash
+are posted with it.
+
+`otel-rum.js` loads it automatically (from the same directory as the RUM
+script) and reuses its service name, base URL and ingest key. Opt out with
+`OtelRUM.init({ excludeTodo: true })` or `data-exclude-todo="true"`. Or load it
+standalone:
+
+```html
+<script src="https://otel.example.com/static/otel-todo.js"
+        data-service-name="checkout-web"
+        data-ingest-key="..."
+        data-components="Header,Cart,Payment"></script>
+```
+
+Components are also discovered from `[data-component="..."]` elements. Other
+options (on the RUM or todo script, or `OtelRUM.init({ todo: {...} })`): `data-shortcut`, `data-hide-button="true"`, `data-base-url`.
+
+- `POST /v1/todos` (ingest key, CORS) body `{project, text, component, path, hash, url, ua, session}`
+- `GET /api/todos?project=<service>&limit=100` (authenticated; omit `project` for all), newest first
+
+Todos go to ClickHouse when configured, else to the JSONL file at `OTEL_TODOS_PATH`
+(default `otel-todos.jsonl`).
+
 ## Backend instrumentation
 
 Instrument backend services with an OpenTelemetry SDK or auto-instrumentation