From b87a6ba1b6a06b6772b472a8c56001974c627b00 Mon Sep 17 00:00:00 2001
From: Ryan Malloy <ryan@supported.systems>
Date: Tue, 10 Feb 2026 14:13:50 -0700
Subject: [PATCH] Add Starlight Aside components to BLE notification docs

---
 docs-site/src/content/docs/guides/ble.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs-site/src/content/docs/guides/ble.md b/docs-site/src/content/docs/guides/ble.md
index d91d2af..0b376d5 100644
--- a/docs-site/src/content/docs/guides/ble.md
+++ b/docs-site/src/content/docs/guides/ble.md
@@ -155,6 +155,10 @@ Returns:
 
 Notification values are automatically buffered (up to 100) and accessible via MCP resources:
 
+<Aside type="tip">
+The `resource_uri` and `history_uri` returned by `bt_ble_notify` can be used directly with `ReadMcpResource` — no need to construct the URI manually.
+</Aside>
+
 ```
 # Latest value and stats
 ReadMcpResource uri="bluetooth://ble/AA:BB:CC:DD:EE:FF/00002a37-.../notifications"
@@ -195,6 +199,10 @@ bt_ble_clear_notification_buffer adapter="hci0" address="..." char_uuid="..."
 
 Clears buffered values while keeping the subscription active.
 
+<Aside type="note">
+Notification buffers persist for the MCP server session lifetime. If the server restarts, subscriptions must be re-enabled.
+</Aside>
+
 ### Disable Notifications
 
 ```