diff --git a/docs/channels/matrix.md b/docs/channels/matrix.md
index 8a2be43d130..3c0240ab278 100644
--- a/docs/channels/matrix.md
+++ b/docs/channels/matrix.md
@@ -853,7 +853,7 @@ Allowlist-style fields (`groupAllowFrom`, `dm.allowFrom`, `groups.<room>.users`)
 - `historyLimit`: number of recent room messages included as `InboundHistory` when a room message triggers the agent. Falls back to `messages.groupChat.historyLimit`; effective default `0` (disabled).
 - `mediaMaxMb`: media size cap in MB for outbound sends and inbound processing.
 
-### Reactions
+### Reaction settings
 
 - `ackReaction`: ack reaction override for this channel/account.
 - `ackReactionScope`: scope override (`"group-mentions"` default, `"group-all"`, `"direct"`, `"all"`, `"none"`, `"off"`).
@@ -871,7 +871,7 @@ Allowlist-style fields (`groupAllowFrom`, `dm.allowFrom`, `groups.<room>.users`)
   - `groups.<room>.skills`: per-room skill filter.
   - `groups.<room>.systemPrompt`: per-room system prompt snippet.
 
-### Exec approvals
+### Exec approval settings
 
 - `execApprovals.enabled`: deliver exec approvals through Matrix-native prompts.
 - `execApprovals.approvers`: Matrix user IDs allowed to approve. Falls back to `dm.allowFrom`.
diff --git a/docs/gateway/pairing.md b/docs/gateway/pairing.md
index 259d880b867..736140a0b11 100644
--- a/docs/gateway/pairing.md
+++ b/docs/gateway/pairing.md
@@ -80,7 +80,7 @@ Node pairing is a trust and identity flow plus token issuance. It does **not** p
 
 - Live node commands come from what the node declares on connect after the gateway's global node command policy (`gateway.nodes.allowCommands` and `denyCommands`) is applied.
 - Per-node `system.run` allow and ask policy lives on the node in `exec.approvals.node.*`, not in the pairing record.
-</Warning>
+  </Warning>
 
 ## Node command gating (2026.3.31+)