5 exercises — choosing between active and passive voice in commit messages, RCA documents, API docs, and user stories.
0 / 15 completed
1 / 15
In a Git commit message, which phrasing follows best practices?
Git commit messages use the imperative mood in active voice — write as if giving an instruction: "Refactor", "Fix", "Add", "Remove". This is the convention established by Git itself and recommended in most style guides (including the Linux kernel guide). The subject ("you" = the commit) is implied. Passive voice in commit messages ("was refactored") is harder to scan in git log and buries the action. Never include the engineer's name in a commit message body — that is already in the author field.
2 / 15
An RCA (root cause analysis) document states the finding. Which sentence is most appropriate?
In RCA documents, passive voice is preferred when reporting system failures and incidents. The focus should be on what happened to the system, not on assigning individual blame. "The production database was deleted" centres the impact without naming a person — this is standard blameless post-mortem practice. Naming an individual (option A) creates blame culture and is discouraged in incident retrospectives. "Got deleted" is too informal for a professional document. Passive voice here is a deliberate, humane technical writing choice.
3 / 15
In API reference documentation, which sentence better explains what an endpoint does?
Modern API documentation prefers active voice with "we" because it is clearer, shorter, and more direct. "We process your request" clearly states the actor (our system = we) and the action. Option A ("Our system will process") is slightly wordier. Option B (passive) is correct but less direct — the passive buries the action after "is processed". Option D ("get processed") is informal and non-standard in professional API docs. Style guides from Stripe, Twilio, and Google APIs all recommend active voice as the default for endpoint descriptions.
4 / 15
A user story reads: "As a user, I want to _____ so that I can access my dashboard." Which verb form correctly completes an active-voice user story?
User stories follow the standard format: As a [user], I want to [action], so that [benefit]. The "I want to" frame requires an active infinitive — a bare infinitive in active voice that expresses what the user does, not what happens to them. "Log in" is correct: the user performs the action. "Be logged in" (passive infinitive) shifts agency away from the user and is grammatically awkward after "I want to". Good user stories keep the user as the active agent, which also helps developers understand the required UX flow.
5 / 15
A system architecture document describes data flow. Which sentence is most appropriate for describing an automated system process where the human actor is unknown or irrelevant?
Passive voice is appropriate in technical architecture documentation when the actor is a system component, unknown, or irrelevant to the reader. "The event is sent to the message queue" keeps the focus on the data flow — what happens to the event — which is what the reader needs to understand the architecture. "Someone sends" is incorrect because an event is triggered by a system, not a person. "We send" implies human action. The present simple passive ("is sent") is the standard choice in architecture diagrams and sequence descriptions.
6 / 15
During a code review, Alex comments: 'The server handles the user authentication.'. Which sentence best reflects active voice and provides more clarity for the reviewer?
The original sentence uses passive voice, obscuring the actor performing the action. Option 1 correctly rephrases it in active voice, clearly stating 'the server' is doing the handling. Options 2 and 3 are overly verbose and still somewhat passive. Option 4 introduces unnecessary personal pronouns, further distancing the reader from the responsibility.
7 / 15
In a Slack message to the team, Ben writes: 'The API endpoint was updated by the system.'. Which of the following revisions uses active voice and provides a more concise update?
Ben's original phrasing is passive and vague. Option 1 uses active voice, directly stating the action was performed by 'the API endpoint has been updated.' This is more direct and easier to understand. Options 2 and 3 are still somewhat passive, while option 4 incorrectly assumes a known actor.
8 / 15
You're drafting the description for a Pull Request introducing a new feature. The PR describes the functionality: 'Data is processed by the service.'. Which sentence best conveys the same information in active voice and promotes clearer communication?
The original sentence employs passive voice, obscuring the agent responsible. Option 0 correctly uses active voice by stating 'The service processes data.' This is the most concise and direct way to describe the function. Options 1 and 2 are unnecessarily verbose, while option 3 introduces an unnecessary personal pronoun.
9 / 15
In a technical document outlining a monitoring system's behavior, Sarah writes: 'The error message is generated when the application encounters a critical issue.'. Which revision best exemplifies active voice and provides a more precise description of the event?
Sarah's original sentence uses passive voice and creates ambiguity about the cause-and-effect relationship. Option 1 clearly states that 'the application' is the actor generating the error message when a critical issue occurs. This active phrasing provides a more precise and understandable description of the system's behavior, avoiding potential confusion.
10 / 15
During a standup meeting, David reports: 'The database query was executed by the background worker.'. Which statement best reflects active voice and provides a concise update on his task?
David's original sentence is passive. Option 1 uses active voice and clearly states that David (the actor) performed the task using the background worker. Options 2 and 3 are too vague, while option 4 introduces unnecessary personal pronouns.
11 / 15
During a code review, Alex comments: 'The server handles the user authentication.'. Which sentence best reflects active voice and provides more clarity for the reviewer?
The original sentence uses passive voice, obscuring the actor performing the action. Option 1 correctly rephrases it in active voice, clearly stating 'the server' is doing the handling. Options 2 and 3 are overly verbose and still somewhat passive. Option 4 introduces unnecessary personal pronouns, further distancing the reader from the responsibility.
12 / 15
In a Slack message to the team, Ben writes: 'The API endpoint was updated by the system.'. Which of the following revisions uses active voice and provides a more concise update?
Ben's original phrasing is passive and vague. Option 1 uses active voice, directly stating the action was performed by 'the API endpoint has been updated.' This is more direct and easier to understand. Options 2 and 3 are still somewhat passive, while option 4 incorrectly assumes a known actor.
13 / 15
You're drafting the description for a Pull Request introducing a new feature. The PR describes the functionality: 'Data is processed by the service.'. Which sentence best conveys the same information in active voice and promotes clearer communication?
The original sentence employs passive voice, obscuring the agent responsible. Option 0 correctly uses active voice by stating 'The service processes data.' This is the most concise and direct way to describe the function. Options 1 and 2 are unnecessarily verbose, while option 3 introduces an unnecessary personal pronoun.
14 / 15
In a technical document outlining a monitoring system's behavior, Sarah writes: 'The error message is generated when the application encounters a critical issue.'. Which revision best exemplifies active voice and provides a more precise description of the event?
Sarah's original sentence uses passive voice and creates ambiguity about the cause-and-effect relationship. Option 1 clearly states that 'the application' is the actor generating the error message when a critical issue occurs. This active phrasing provides a more precise and understandable description of the system's behavior, avoiding potential confusion.
15 / 15
During a standup meeting, David reports: 'The database query was executed by the background worker.'. Which statement best reflects active voice and provides a concise update on his task?
David's original sentence is passive. Option 1 uses active voice and clearly states that David (the actor) performed the task using the background worker. Options 2 and 3 are too vague, while option 4 introduces unnecessary personal pronouns.
What will I practise in "Active vs Passive Voice in Technical Contexts | CoderSlingo"?
Practise voice choice in commit messages, RCA documents, API docs, and user stories. 5 interactive grammar exercises.
How many exercises are in this module?
This module has 15 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 grammar rule 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 Grammar exercises?
Browse the full Grammar 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 grammar rules in prose; this exercise tests and reinforces those rules 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.