Anaphora — Pronoun Reference in Technical Documentation
5 exercises — using it/this/these/the former/the latter correctly to avoid repetition while maintaining clarity in API documentation, incident reports, and technical specifications.
0 / 17 completed
1 / 17
An API reference states: "The POST /auth/token endpoint accepts a client ID and a client secret. It returns a signed JWT valid for 3600 seconds." What does "it" refer to, and is this usage clear?
Option B is correct.Pronoun reference (anaphora) resolves to the most topic-prominent noun — the subject of the previous sentence. Here "it" refers to the endpoint (POST /auth/token), which is the sentence topic. The reference is clear because only one plausible agent can "return" a JWT. Option A is incorrect — the JWT is the object of the return, not the agent. Option C (recency principle) is the default in ambiguous cases, but topic-prominence overrides it here. In API documentation, "it" after an endpoint description almost always refers to the endpoint.
2 / 17
A technical specification reads: "The authentication service validates the token. The token is then forwarded to the resource server. This checks the token's scope before granting access." Is the use of "this" clear?
Option B is correct.Ambiguous pronoun reference is a common problem in technical documentation. "This" can refer to the token (most recently mentioned noun), the resource server (most recent subject), or the process (sentence-level anaphora). The fix is to use the full noun: "The resource server checks the token's scope before granting access." Option A assumes the reader applies recency + subject tracking, which is a cognitive burden. Option C (macro-anaphora) is valid when "this" sums up a process, but here a specific action is described, making a clear noun referent essential.
3 / 17
A design document states: "The write-ahead log (WAL) and the buffer pool are the two core components of the storage engine. The former ensures durability; the latter manages in-memory page caching." Is this use of "the former" and "the latter" appropriate?
Option A is correct."The former…the latter" is a formal anaphoric pro-form pair used in technical and academic writing to refer back to two previously mentioned items in order (former = first-mentioned, latter = second-mentioned). It is appropriate when the two referents are introduced together in the same sentence and the anaphoric sentence immediately follows. Option B is incorrect — bullet-point formatting is not required. Option C is a matter of register preference, not a rule; these forms are acceptable and common in formal technical documentation.
4 / 17
An incident report reads: "The deployment pipeline failed. The rollback procedure was initiated. This caused additional downtime because of a misconfigured health check." How should "this" be improved?
Option B is correct. In incident reports, precise noun repetition is preferred over pronouns for critical causal claims. "This caused additional downtime" is ambiguous — "this" could refer to the deployment failure, the rollback procedure, or the entire sequence of events. Repeating "the rollback procedure" removes all ambiguity and makes the causal chain explicit and auditable. Option D is incorrect — even if "this" probably refers to the rollback, technical writing standards for incident reports require unambiguous attribution. Option A worsens the problem — "it" has the same ambiguity.
5 / 17
An API changelog entry states: "Version 2.3 introduces rate limiting at the gateway level. These apply per API key and reset every 60 seconds." What is the grammatical problem with "these"?
Option A is correct."Rate limiting" is a non-count (mass) noun — it cannot be pluralised directly. "These" requires a plural count noun antecedent. The sentence implies "rate limits" (plural count noun) but does not use that form. The fix is to be explicit: "These rate limits apply per API key and reset every 60 seconds." Option B partially addresses the problem — "this" + singular works ("This rate limiting applies…") but the pronoun-heavy version is still less precise. Option C is grammatically strained. In technical changelogs, prefer explicit nouns over pronouns when describing new features.
6 / 17
Reviewer: 'The server responds with a 500 error. The documentation states the endpoint handles JSON payloads. Let's investigate.'
PR Description: 'We've updated the API to support larger requests. The server now returns a 500 if the payload exceeds 1MB. This is documented in the README.'
Which pronoun, if any, could be improved for clarity in this PR description?
The pronoun 'this' is the best choice here because it directly refers back to the previously mentioned endpoint. While 'the server' isn't *incorrect*, its repeated use adds unnecessary detail and can make the description feel clunky. The key to clear technical writing is specificity – avoid vague references when a more precise term exists.
7 / 17
Reviewer: 'The server responds with a 500 error. The documentation states the endpoint handles JSON payloads. Let's investigate.'
PR Description: 'We've updated the API to support larger requests. The server now returns a 500 if the payload exceeds 1MB. This is documented in the README.'
Which pronoun, if any, could be improved for clarity in this PR description?
The pronoun 'this' is the best choice here because it directly refers back to the previously mentioned endpoint. While 'the server' isn't *incorrect*, its repeated use adds unnecessary detail and can make the description feel clunky. The key to clear technical writing is specificity – avoid vague references when a more precise term exists.
8 / 17
Reviewer: 'The server responds with a 500 error. The documentation states the endpoint handles JSON payloads. Let's investigate.'
PR Description: 'We've updated the API to support larger requests. The server now returns a 500 if the payload exceeds 1MB. This is documented in the README.'
Which pronoun, if any, could be improved for clarity in this PR description?
The pronoun 'this' is the best choice here because it directly refers back to the previously mentioned endpoint. While 'the server' isn't *incorrect*, its repeated use adds unnecessary detail and can make the description feel clunky. The key to clear technical writing is specificity – avoid vague references when a more precise term exists.
9 / 17
Slack Message: 'Hey team, the new build is failing. The error message says 'Insufficient memory allocated'. It seems like the process is trying to allocate more than it's allowed.' Does this Slack message effectively use anaphora?
This message utilizes 'it' as anaphora, referring back to the error message. However, a stronger phrasing would replace 'it' with 'the error message' or 'the process' for absolute clarity, especially when dealing with technical details. The ambiguity of 'it' can lead to confusion and requires more specific language.
10 / 17
Code Review Comment: 'The function handles user authentication. The API endpoint returns a success or error response based on the validation.' What is wrong with this comment regarding anaphora?
The problem lies in 'The API'. This could refer to any endpoint handling authentication. It's better to specify *which* API endpoint is being discussed – e.g., 'The /login endpoint returns…' This eliminates ambiguity and strengthens the comment's clarity.
11 / 17
Standup Update: 'I fixed a bug in the logging service. The fix now correctly records all events.' What is the primary issue with this statement regarding anaphora?
While 'The fix' likely refers back to the logging service and its changes, the statement lacks sufficient detail for someone unfamiliar with the system. Adding a brief description of *what* was fixed – e.g., 'I fixed a bug in the logging service that prevented event recording' – would eliminate ambiguity and improve comprehension.
12 / 17
API Response: The server responded with the following JSON: { "status": "success", "data": { "user_id": 12345 } }. The documentation states: 'Upon successful authentication, the server returns this data.' What does 'this' refer to in the API response documentation?
Here, 'this' unambiguously refers to the entire JSON object returned by the server. The documentation clearly states that upon successful authentication, the server returns *that* specific JSON structure. This demonstrates a correct and concise use of anaphora.
13 / 17
During a code review, Alice comments: 'The service sends data to the database. The response indicates success.' What potential issue does this sentence present regarding anaphora?
Alice uses 'the response' without a clear antecedent. This ambiguity could lead to confusion about whether she's referring to the HTTP status code or the data itself. The problem is that 'the response' could refer to multiple things within the context of sending data to a database, creating potential misunderstanding.
14 / 17
In a Slack message discussing a deployment failure, Ben writes: 'The new version is deployed. The logs show a timeout error.' What's the primary issue with this message concerning anaphora?
Ben's sentence presents ambiguity. While he links 'the new version' and 'the logs,' it doesn't explain *why* the logs show a timeout error in relation to the deployed version. The reader is left wondering if the deployment itself caused the problem or if the logs simply reveal an existing issue.
15 / 17
A PR description states: 'The service now handles large payloads. The API returns a 200 status code upon successful processing.' What is the grammatical weakness of this statement regarding anaphora?
The phrase 'the API' is ambiguous. It's not clear which specific API endpoint or system is returning the 200 status code. While grammatically correct, it leaves room for misinterpretation and could benefit from specifying *which* API.
16 / 17
During a standup update, David says: 'I fixed the database connection issue. The fix now allows users to access data.' What is the core problem with this statement from an anaphora perspective?
David uses 'the fix' without specifying what element of the database connection issue was resolved. This leaves the listener unsure whether it's a code change, a configuration update, or something else that now allows users to access data. The lack of detail makes it difficult to understand the scope of the solution.
17 / 17
A code review comment reads: 'The function processes user input. The API endpoint responds with a JSON payload.' What potential issue does this present regarding anaphora?
The comment uses 'the API endpoint' without specifying which one. This creates ambiguity as there might be several endpoints involved in the overall process of handling user input and returning a JSON payload. Clarifying *which* endpoint is crucial for understanding the flow.
What will I practise in "Anaphora in Technical Documentation — Grammar Exercise"?
Practise using pronouns and pro-forms (it/this/these/the former/the latter) clearly in API documentation and technical specifications.
How many exercises are in this module?
This module has 17 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.