demo/narration.md

@@ -24,8 +24,7 @@ full system recovery to get back to the moment before it touched anything.
 Zerto environment.
 
 [d2] The machine is a production Windows server, and Zerto is already protecting it.
-The agent has been asked to change a configuration file on that server, and
+The agent has been asked to change a configuration file on that server.
-there's no other copy of that file anywhere.
 
 [d3] Before it changes anything, it asks Zerto a simple question. Is this machine
 protected, and which protection group is it in?
@@ -34,8 +33,8 @@ protected, and which protection group is it in?
 until Zerto confirms that checkpoint is really there before it goes any further.
 
 [d5] Now the change goes in, and it breaks the file. The version that was there is
-gone, and the only other copy is in last night's backup, which is already hours
+gone from the server. Backup has a copy from last night, so that's hours old
-behind.
+already. Zerto has one from seconds before the change.
 
 [d6] The agent can't just recover on its own. Recovery has to be approved by a
 person, so at this point it stops and asks.

demo/vo/build_narration.py

@@ -11,7 +11,9 @@ beats = re.findall(r"\[([id]\d+)\]\s*(.*?)(?=\n\n|\Z)", SRC.read_text(), re.S)
 lines = {k: " ".join(v.split()) for k, v in beats}
 (SP / "narration.json").write_text(json.dumps(lines, indent=2) + "\n")
 
-REPLACE = {"VM": "vee em", "ad1": "A D one"}   # customer-facing script: few acronyms left
+# Do NOT map an acronym to run-together phonetics: {"VM": "vee em"} is spoken
+# as one word, "vem". Expand it instead, or leave it alone.
+REPLACE = {"VM": "virtual machine"}
 out = {}
 for key, text in lines.items():
     body = {"text": text, "voice_id": VOICE, "language": "en", "speed": SPEED,