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
 
 ```