Runbook Writing — Vocabulary and Operational Language
Learn vocabulary for writing operational runbooks: pre-conditions, steps, rollback, verification, and on-call language.
0 / 10 completed
1 / 10
What is a 'runbook' in operational vocabulary?
A runbook is an operational recipe: step-by-step procedures for specific scenarios (deploy, rollback, incident response, maintenance). Good runbooks are written so a new on-call engineer unfamiliar with the system can follow them successfully at 3am under pressure. They are living documents updated after every use.
2 / 10
What are 'pre-conditions' in a runbook?
Pre-conditions for a runbook: 'System is in healthy state except for X. You have SSH access to production servers. Deployment pipeline is green. You have reviewed and understood the full procedure before beginning.' Pre-conditions prevent operators from starting a procedure they cannot safely complete.
3 / 10
What is a 'rollback procedure' in a runbook?
Every runbook for changes (deployments, config changes, migrations) needs a rollback procedure: 'If Step 5 fails or the system behaves unexpectedly after Step 7, execute the following to restore the previous state: [steps].' Rollback procedures must be tested. A runbook without a rollback is dangerous for production operations.
4 / 10
What is 'verification step' language in a runbook?
Verification steps prevent operator errors from compounding: 'VERIFY: The deployment has completed. Run `kubectl rollout status deployment/api` — you should see: successfully rolled out. Do NOT proceed to the next step until this verification passes.' Explicit verification gates turn a procedure into a safe, auditable process.
5 / 10
What is 'escalation path' in a runbook?
Escalation path: 'If the procedure does not resolve the issue within 15 minutes, escalate to the on-call backend lead via PagerDuty. Include: timeline of actions taken, current system state, and relevant log snippets. Do not continue attempting this procedure without guidance.' Runbooks should explicitly tell operators when to stop and get help.
6 / 10
Alice, a junior developer, is drafting a runbook for deploying the new 'Phoenix' microservice. She writes: 'Deploy Phoenix to staging. Verify service health.' Which phrase best describes her use of 'verify service health'?
The phrase 'verify service health' is a common runbook term indicating a specific action to confirm the microservice is functioning correctly. It's not sufficient on its own; a good verification step would detail *how* health is measured (e.g., response times, error rates). This phrasing alone doesn't provide enough operational clarity.
7 / 10
Ben needs to update the Slack channel with a status report on an ongoing deployment. He types: 'Deployment progressing – some minor issues encountered. Investigating.' What does 'Investigating' most accurately convey in this context?
'Investigating' in this scenario signals that Ben is actively taking steps to resolve the 'minor issues.' It's a crucial element of runbook language, indicating an ongoing operational process. Simply stating 'some minor issues encountered' without action is less effective for maintaining situational awareness.
8 / 10
Chloe is writing a PR description for a change to the authentication service's API. She includes: 'Updated endpoint /users/login with rate limiting.' What does 'rate limiting' refer to in this context?
'Rate limiting' is a common practice in APIs – it restricts the number of requests a client can make within a certain timeframe. This protects the service from overload and abuse. Adding this explanation clarifies the technical purpose behind the change and demonstrates good operational documentation.
9 / 10
David is presenting an update during a daily standup meeting. He says: 'The database migration failed due to a deadlock. We've initiated the rollback procedure.' What does 'initiated the rollback procedure' primarily communicate?
'Initiated the rollback procedure' clearly states that David and his team have begun the process of undoing the failed database migration. This communicates progress and action taken during an operational incident – essential information for a stand-up update. It's crucial to show *what* was done.
10 / 10
Emily is creating a runbook for restarting the 'Hydra' application server. The runbook includes: 'Restart Hydra.' Which phrase would be MOST appropriate to add *after* this initial command to ensure a successful restart?
While 'Restart Hydra' initiates the action, it isn't a fully operational runbook step. Following the restart with verification (e.g., 'Verify Hydra is running', or 'Check logs for errors') ensures that the restart was successful and prevents potential problems. This demonstrates proactive operational monitoring.
What will I practise in "Runbook Writing — Vocabulary and Operational Language"?
Learn vocabulary for writing operational runbooks: pre-conditions, steps, rollback, verification, and on-call language.
How many exercises are in this module?
This module has 10 multiple-choice exercises, each with instant feedback and a full explanation of the correct answer.
Is this exercise free to use?
Yes. Every exercise on CoderSlingo, including this one, is free to use with no account, sign-up, or paywall.
Do I need to create an account to do these exercises?
No account is required. Just click an option to answer — your score for this session is tracked automatically in the progress bar above.
What happens if I choose the wrong answer?
You'll immediately see which answer was correct, plus a full explanation covering the vocabulary and reasoning behind it — mistakes are where most of the learning happens.
Can I retry the exercises if I want a higher score?
Yes — use the "Try again" button on the results screen to reset and go through all the questions again.
Is my progress saved if I close the page?
No. Progress is tracked only for your current visit; reloading or leaving the page resets the counter. This keeps the exercise simple and account-free.
Where can I find more Knowledge Base Writing exercises?
Browse the full Knowledge Base Writing hub for related drills, or check the "Next up" link below to continue with a connected topic.
How is this different from reading an article on the same topic?
Articles explain vocabulary and concepts in prose; this exercise tests and reinforces that vocabulary through active recall with immediate feedback — the two work best together.
Who writes these exercises?
Every exercise is written by the CoderSlingo team, drawing on real workplace English used in IT roles, then reviewed for accuracy and clarity.