Title: Discussion 14 — Runbook Stress Test
Course: AIINFRA 303: Capstone Project > Section: Week 14 — Documentation, Runbooks, and Reproducibility

💬 Discussion 14 — Runbook Stress Test (20 pts)

Hand your incident runbook to a classmate who has never seen your capstone project before, and ask them to try to follow it to resolve a simulated version of the incident (you can walk them through it live, over screen share, or just have them read it and narrate what they'd do at each step). Then post:

1. Which step(s) tripped them up or needed more detail than you'd written, and why do you think you missed that gap as the author?
2. Did the runbook's expected outputs actually let them self-verify they were on the right track, or did they have to guess/ask you?
3. What is one concrete edit you made to the runbook as a result of this test?

Then respond to at least two classmates: try running one section of their runbook yourself (even hypothetically) and tell them whether you could have followed it as a stranger, and why.