# Revision Brief: Chapter 6 - The Waiting Game This is the concrete map for the iterative revision of Chapter 6. ## 1. Strengthen Opening Motivation (6.0) - Add the **"Top 10 Heavyweight Queries"** SQL using `pg_stat_statements` to provide immediate power to the reader. - Unify the **"Shapes of Misery"** with the **"Diner vs. Factory"** roles. ## 2. Unify Terminology (6.1, 6.1.x) - **CRITICAL**: Eliminate "Waiters" for Postgres processes. Use "Chefs" or "Staff" exclusively. - Reserve **"Waiter"** for the Application/Client (6.1.1 alignment). - Consolidate **IPC / Activity / Extensions** into a single section if appropriate. ## 3. Merge Administrative Over-granularity (6.2, 6.3) - Merge **6.2.3 (ControlFile)** and **6.2.4 (SLRU)** into one "Infrastructure Ledgers" chapter. - Merge **6.3.2 (LWLocks)** and **6.3.3 (LockManager)** into one "Microscopic Traffic" chapter. - This reduces the "choppiness" of the technical deep-dives. ## 4. Split and Annotate Dense Middle Sections (6.3) - Break down the **Blocking Query** into logical parts (Symptom vs. Disease). - Add clear **"Why does this happen?"** callouts for obscure locks (e.g., `RelationMap`). ## 5. Global Syntax & Typos (All Files) - Add missing `---` head delimiters. - Fix all identified typos ("Scavenger", "shiftfield"). ## 6. Closure & Pacing - Ensure the **"Diagnostic Trio"** in 6.5 correctly summarizes the *new* structure of the chapter.