From 889aefc903206e777feb07f7edba47383f915562 Mon Sep 17 00:00:00 2001
From: Roomote <roomote@roomote.dev>
Date: Sat, 5 Sep 2026 03:08:27 +0000
Subject: [PATCH] docs: document Live Preview recovery

---
 apps/docs/tasks.mdx | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/apps/docs/tasks.mdx b/apps/docs/tasks.mdx
index ac39be512..1e17f40a6 100644
--- a/apps/docs/tasks.mdx
+++ b/apps/docs/tasks.mdx
@@ -77,6 +77,12 @@ Generated HTML artifacts open in a sandboxed **Preview** by default. Switch to
 **Code** to inspect the saved HTML source without executing it in the page that
 runs the Roomote dashboard.
 
+If Live Preview cannot load, the panel distinguishes a failed status check from
+a page-load timeout or environment setup problem. Select **Try again** to repeat
+the failed check or reload the preview. When a completed task is asleep and has
+a restorable snapshot, select **Wake up** to resume it before opening Live
+Preview. An expired snapshot cannot be resumed; start a new task instead.
+
 ### Native widget styling
 
 Roomote widgets inherit the task view's selected light or dark theme. Agents can