5 exercises — using that, whether, and what correctly in tickets, status updates, and design docs.
0 / 5 completed
1 / 5
Choose the correct noun clause introducer for this Jira ticket comment:
"The team agreed _____ the deployment should be delayed until the flaky tests are resolved."
That introduces a noun clause used as the object of "agreed" when reporting a decision or fact: agreed that X. The clause "the deployment should be delayed" is a complete statement (not a question), so "whether" is wrong. "What" would require a gap in the clause — e.g., agreed what should happen — but "the deployment should be delayed" is already a full clause with no missing element. "Which" introduces relative clauses, not noun clauses in object position. Ticket-writing tip: agreed that, confirmed that, noted that, and decided that are all followed by a "that"-clause. In informal writing, "that" is sometimes omitted: "The team agreed the deployment should be delayed" — but in formal documentation, keeping "that" improves clarity.
2 / 5
A runbook instruction reads:
"Before restarting the service, we need to check _____ the health endpoint returns HTTP 200."
Which word is most appropriate for formal operational documentation?
Whether is preferred in formal technical documentation when embedding a yes/no question. Although "if" is widely used in spoken English and informal writing, "whether" eliminates ambiguity: check if can be misread as a conditional ("check in the case that"), whereas check whether unambiguously means "verify yes or no". "That" would change the meaning to reporting a known fact rather than verifying an unknown state. "What" would require a different clause structure: "check what the endpoint returns". Runbook/SRE style guides (Google SRE, PagerDuty) consistently use verify whether or confirm whether in procedural steps. After "wonder", "ask", "determine", "test", and "verify", prefer "whether" in formal prose.
3 / 5
Complete this release checklist item so the noun clause functions as the grammatical subject:
"_____ the pipeline passed all checks is a prerequisite for merging to main."
That introduces a noun clause used as the sentence subject, asserting a known or required fact. "That the pipeline passed all checks" = a fact being stated as a condition. Whether would introduce uncertainty ("it is not yet decided"), which contradicts the tone of a prerequisite statement. What would require a gap in the clause — e.g., "What the pipeline passed" is incomplete without a missing object. It alone is a pronoun, not a clause introducer; it would need a paired structure: "It is a prerequisite that the pipeline passed all checks" — which is grammatical but uses extraposition (moving the clause to the end), a different construction. Formal style: "That X is Y" (subject noun clause) appears in specs and release notes when stating requirements or preconditions.
4 / 5
A status update in a design doc reads:
"The monitoring dashboard shows _____ average response time has increased by 300 ms over the past 24 hours."
Which option is correct?
That introduces a noun clause reporting a factual observation as the object of "shows". The clause "average response time has increased by 300 ms" is a complete declarative statement — it reports a fact, not a question or an unknown. What would require a missing element: "shows what happened" (where "what" fills the object role inside the clause). Here the clause already has a subject ("average response time") and object ("300 ms"), so "what" creates a surplus. Whether implies uncertainty — "we do not yet know" — which contradicts the monitoring data being presented as a finding. How would work only if measuring manner or degree: "shows how significantly response time has increased." Status-update convention: use shows that / confirms that / indicates that for reporting observed metrics.
5 / 5
An API reference doc contains two sentences. Which version correctly uses a noun clause (not a relative clause)?
A: "This function returns what the parser extracts from the token stream." B: "This function returns the value that the parser extracts from the token stream."
Both sentences are grammatically correct, but they have subtly different meanings. Sentence A uses a free relative clause (noun clause): "what the parser extracts" means "whatever the parser extracts" — the function returns the extracted value itself, and the exact type is unspecified or variable. Sentence B uses a restrictive relative clause: "the value that the parser extracts" refers to a specific, known value. B implies a definite, identifiable return type, which is typically more precise in API documentation. Practical guidance: use what-clauses when the return is flexible or polymorphic; use the X that when the return type is fixed and documented. "Which" (option D) would make B non-restrictive and change the meaning further. In TypeScript/Java API docs, the "the X that" pattern aligns better with typed return signatures.