Video scripts: comments are one line, ten words

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

site/video/update-0.1.5/record/drive.py

@@ -1,4 +1,4 @@
-"""Real input, window placement and screen capture for the update video."""
+"""Real input, window placement and capture for the video."""
 import ctypes
 import json
 import math
@@ -94,7 +94,7 @@ class Take:
         time.sleep(1.5)
         if self.proc.poll() is not None:
             raise RuntimeError("the capture stopped at once")
-        # A square flashes in a corner; a frame diff finds it.
+        # A corner square flashes; a frame diff finds it.
         front = user32.GetForegroundWindow()
         flash = tkinter.Tk()
         flash.overrideredirect(True)

site/video/update-0.1.5/record/prep.py

@@ -1,16 +1,11 @@
-"""Copies synced takes into public/footage with events in footage time.
-
-Usage: prep.py <takes dir>
-Writes public/footage/<name>.mp4 and <name>.json: {fps, size, events, menus}.
-Event times are footage seconds; positions are footage pixels (2048×1152).
-"""
+"""Copies synced takes into public/footage: prep.py <takes dir>"""
 import json
 import shutil
 import sys
 from pathlib import Path
 
 TAKES = ["menus", "cells", "doc", "table", "show", "more"]
-# Submenu panels as recorded (x0, y0, x1, y1), for the safe triangle.
+# Recorded submenu panels (x0, y0, x1, y1) for the triangle.
 SUBMENUS = {
     "menus": {"parent": [1100, 610, 1396, 652], "panel": [1394, 576, 1784, 1144]},
     "doc": {"parent": [1072, 702, 1370, 742], "panel": [1364, 698, 1660, 874]},

site/video/update-0.1.5/record/sync.py

@@ -1,9 +1,4 @@
-"""Finds each take's sync jump; writes footage time = log time + offset.
-
-Usage: sync.py <takes dir> <name> ...
-Converts each take to constant 60 fps (`<name>.60.mp4`) and writes
-`<name>.sync.json` with the offset and the source start time.
-"""
+"""Syncs takes to their logs: sync.py <takes dir> <name> ..."""
 import json
 import subprocess
 import sys

site/video/update-0.1.5/record/takes.py

@@ -1,4 +1,4 @@
-"""The recorded takes. Usage: takes.py <out dir> <samples dir> [take ...]"""
+"""Records the takes: takes.py <out> <samples> [take ...]"""
 import shutil
 import subprocess
 import sys