diff --git a/src/js/dom.ts b/src/js/dom.ts
index 7e0a01a..7bc06af 100644
--- a/src/js/dom.ts
+++ b/src/js/dom.ts
@@ -1,6 +1,5 @@
 ////
-// dom helpers and cached elements
-//
+// DOM helpers and cached elements
 
 // finds an element by ID
 export const $ = (id: string): HTMLElement | null =>
diff --git a/src/js/focus.ts b/src/js/focus.ts
index c8ce8d1..8e4c00c 100644
--- a/src/js/focus.ts
+++ b/src/js/focus.ts
@@ -1,6 +1,5 @@
 ////
-// try to keep the command textbox focused at all times
-//
+// We try to keep the command textbox focused at all times.
 
 import { cmdTextbox } from "./dom.js"
 
diff --git a/src/js/input.ts b/src/js/input.ts
index 01f807d..5d6eaff 100644
--- a/src/js/input.ts
+++ b/src/js/input.ts
@@ -1,6 +1,5 @@
 ////
-// input is handled by a <textarea> and friends
-//
+// Terminal input is handled by a <textarea> and friends.
 
 import { cmdTextbox, cmdLine } from "./dom.js"
 import { runCommand } from "./shell.js"
diff --git a/src/js/resize.ts b/src/js/resize.ts
index 61b78fd..2b46051 100644
--- a/src/js/resize.ts
+++ b/src/js/resize.ts
@@ -1,6 +1,5 @@
 ////
-// maintain the two video modes: cinema and tall
-//
+// We need JS to help manage the two video modes: cinema and tall
 
 const content = document.getElementById("content")!
 
diff --git a/src/js/shell.ts b/src/js/shell.ts
index dc9ce96..d0fe0cb 100644
--- a/src/js/shell.ts
+++ b/src/js/shell.ts
@@ -1,6 +1,7 @@
 ////
-// the shell runs on the server and processes input, returning output
-//
+// The shell runs on the server and processes input, returning output.
+
+import type { Message } from "../shared/message.js"
 
 export function runCommand(input: string) {
 
diff --git a/src/js/vram.ts b/src/js/vram.ts
index 3c52840..6684460 100644
--- a/src/js/vram.ts
+++ b/src/js/vram.ts
@@ -1,6 +1,5 @@
 ////
-// fun vram counter at startup
-//
+// Fun vram counter at startup.
 
 import { $ } from "./dom.js"
 
diff --git a/src/js/websocket.ts b/src/js/websocket.ts
index 6ee9e75..fe921ef 100644
--- a/src/js/websocket.ts
+++ b/src/js/websocket.ts
@@ -1,6 +1,5 @@
 ////
-// the terminal communicates with the shell via websockets
-//
+// The terminal communicates with the shell via websockets.
 
 import type { Message } from "../shared/message.js"