From 8a3ac542041ff5ca3352c55111b25121d693205e Mon Sep 17 00:00:00 2001
From: ReaperOfVeriod <reaperofveriod@gmail.com>
Date: Sun, 25 Oct 2026 06:32:07 +0100
Subject: [PATCH] Document overlay editor workflow

---
 docs/overlays.md | 13 +++++++++++++
 1 file changed, 13 insertions(+)
 create mode 100644 docs/overlays.md

diff --git a/docs/overlays.md b/docs/overlays.md
new file mode 100644
index 0000000..f2513b6
--- /dev/null
+++ b/docs/overlays.md
@@ -0,0 +1,13 @@
+# Overlay editor
+
+The Overlays view edits HTML, CSS, and JavaScript independently. Each source
+tab shows line numbers and a small completion picker containing literal starter
+snippets. Selecting a completion only inserts text into the active draft; it
+does not execute or evaluate the snippet in the client.
+
+Draft changes are cached locally and autosaved to the server after the debounce
+period. The live preview uses a sandboxed iframe. Publishing is a separate
+explicit action that changes the OBS browser-source output; saving a draft does
+not publish it. Diagnostics remain available through the warning indicator,
+and the server applies the authoritative size, slug, and browser-source
+security checks.