Move demo captions into tape files

Author: gkthiruvathukal

README.md

@@ -86,6 +86,9 @@ make demo-all
 
 Individual tape variants are also available, for example `make demo-stack-dark` or `make demo-dll-light`. Generated `.mp4` files are written to `demos/`.
 
+For maintenance details about timing, caption placement, and caption wording, see:
+- `docs/DemoVideoMaintenance.md`
+
 ## All Valid Targets
 
 | Target | Description |

demos/stack-dark.tape

@@ -21,85 +21,104 @@ Enter
 Sleep 10s
 
 # ── Build stack: 10 at bottom, 50 at top ────────────────────────────────────
+# CAPTION: Push 5 values onto the stack
 Type "/push 10 20 30 40 50"
 Enter
 Sleep 2s
 
 # ── Inspect ─────────────────────────────────────────────────────────────────
+# CAPTION: Peek at the top value
 Type "/peek"
 Enter
 Sleep 1.5s
 
+# CAPTION: Inspect the top stack position
 Type "/at 0"
 Enter
 Sleep 1.5s
 
+# CAPTION: Inspect a deeper stack position
 Type "/at 2"
 Enter
 Sleep 1.5s
 
 # ── Stack manipulation ───────────────────────────────────────────────────────
+# CAPTION: Duplicate the top value
 Type "/dup"
 Enter
 Sleep 2s
 
+# CAPTION: Pop the top value
 Type "/pop"
 Enter
 Sleep 1.5s
 
+# CAPTION: Swap the top two values
 Type "/swap"
 Enter
 Sleep 2s
 
+# CAPTION: Rotate the top three values
 Type "/rotate"
 Enter
 Sleep 2s
 
 # ── Pop a couple ─────────────────────────────────────────────────────────────
+# CAPTION: Pop the top value again
 Type "/pop"
 Enter
 Sleep 1.5s
 
+# CAPTION: Pop one more value
 Type "/pop"
 Enter
 Sleep 1.5s
 
 # ── Undo / redo ─────────────────────────────────────────────────────────────
+# CAPTION: Undo the previous change
 Type "/undo"
 Enter
 Sleep 1.5s
 
+# CAPTION: Undo one more change
 Type "/undo"
 Enter
 Sleep 1.5s
 
+# CAPTION: Redo the last undone change
 Type "/redo"
 Enter
 Sleep 1.5s
 
 # ── Save current state ───────────────────────────────────────────────────────
+# CAPTION: Save the current stack session
 Type "/save /tmp/stack-demo.json"
 Enter
 Sleep 1.5s
 
 # ── Switch to strings and generate random values ─────────────────────────────
+# CAPTION: Clear the stack
 Type "/clear"
 Enter
 Sleep 1s
 
+# CAPTION: Switch the stack to string values
 Type "/type str"
 Enter
 Sleep 1s
 
+# CAPTION: Generate 5 random string values
 Type "/random 5"
 Enter
 Sleep 2s
 
 # ── Load the saved int session back ─────────────────────────────────────────
+# CAPTION: Clear before loading the saved session
 Type "/clear"
 Enter
 Sleep 1s
 
+# CAPTION: Load the saved integer session
 Type "/load /tmp/stack-demo.json"
 Enter
 Sleep 2s

demos/stack-light.tape

@@ -21,85 +21,104 @@ Enter
 Sleep 10s
 
 # ── Build stack: 10 at bottom, 50 at top ────────────────────────────────────
+# CAPTION: Push 5 values onto the stack
 Type "/push 10 20 30 40 50"
 Enter
 Sleep 2s
 
 # ── Inspect ─────────────────────────────────────────────────────────────────
+# CAPTION: Peek at the top value
 Type "/peek"
 Enter
 Sleep 1.5s
 
+# CAPTION: Inspect the top stack position
 Type "/at 0"
 Enter
 Sleep 1.5s
 
+# CAPTION: Inspect a deeper stack position
 Type "/at 2"
 Enter
 Sleep 1.5s
 
 # ── Stack manipulation ───────────────────────────────────────────────────────
+# CAPTION: Duplicate the top value
 Type "/dup"
 Enter
 Sleep 2s
 
+# CAPTION: Pop the top value
 Type "/pop"
 Enter
 Sleep 1.5s
 
+# CAPTION: Swap the top two values
 Type "/swap"
 Enter
 Sleep 2s
 
+# CAPTION: Rotate the top three values
 Type "/rotate"
 Enter
 Sleep 2s
 
 # ── Pop a couple ─────────────────────────────────────────────────────────────
+# CAPTION: Pop the top value again
 Type "/pop"
 Enter
 Sleep 1.5s
 
+# CAPTION: Pop one more value
 Type "/pop"
 Enter
 Sleep 1.5s
 
 # ── Undo / redo ─────────────────────────────────────────────────────────────
+# CAPTION: Undo the previous change
 Type "/undo"
 Enter
 Sleep 1.5s
 
+# CAPTION: Undo one more change
 Type "/undo"
 Enter
 Sleep 1.5s
 
+# CAPTION: Redo the last undone change
 Type "/redo"
 Enter
 Sleep 1.5s
 
 # ── Save current state ───────────────────────────────────────────────────────
+# CAPTION: Save the current stack session
 Type "/save /tmp/stack-demo.json"
 Enter
 Sleep 1.5s
 
 # ── Switch to strings and generate random values ─────────────────────────────
+# CAPTION: Clear the stack
 Type "/clear"
 Enter
 Sleep 1s
 
+# CAPTION: Switch the stack to string values
 Type "/type str"
 Enter
 Sleep 1s
 
+# CAPTION: Generate 5 random string values
 Type "/random 5"
 Enter
 Sleep 2s
 
 # ── Load the saved int session back ─────────────────────────────────────────
+# CAPTION: Clear before loading the saved session
 Type "/clear"
 Enter
 Sleep 1s
 
+# CAPTION: Load the saved integer session
 Type "/load /tmp/stack-demo.json"
 Enter
 Sleep 2s