/review-results-discussion
Diagnose the section the course calls the heart of the paper. The most common failures here are
structural rather than stylistic: results described but never interpreted, results interpreted but
never compared to prior work, and paragraphs that run on because nobody decided where they should
end.
This reviews the writing, not the science. You do not judge whether the results are good, only
whether the text delivers them.
Before anything else
- Load the style rules. Invoke
paper-writing-style and read references/human-voice.md.
- Lock the language. Language of the user's first message, whole run. Rewrites are English.
- Get the material. The section, the figures and captions, the
.bib, and the introduction if
available, since the two must connect.
Pass 1: information classes, per result block
Split the section into result blocks, one per figure, table or distinct finding. For each, mark
which of the four classes is present:
| Class |
Present? |
| Background, why this analysis matters |
|
| Description, what the result shows, with values |
|
| Interpretation, the explanation offered |
|
| Comparison, how it relates to prior work, with citations |
|
Present this as a matrix: result blocks down the side, the four classes across the top. The gaps
are immediately visible, and the pattern of gaps is the finding.
Then report, most serious first:
- Missing description with values. A block that says a property "improved" or was "excellent"
without numbers. This is the most serious defect available in this section.
- Missing interpretation. Description with no explanation is a data dump. Name each block.
- Missing comparison. No relation to prior work means the reader cannot tell whether the
result is good. Very common, and cheap to fix.
- Missing background where a reader would not know why the analysis was run.
- Results with no corresponding figure, table or text location, or figures never discussed in
the text. Both directions are defects.
Pass 2: topic sentences and paragraph boundaries
For each paragraph:
- Identify the topic sentence. Does the first sentence carry a topic (keyword) and a message
(a claim about it)? Report paragraphs that open with something else, for example a bare methods
statement or a figure reference with no claim.
- Check every following sentence relates to that topic or that message. Report strays.
- Check the boundary. A paragraph that changes topic or message halfway should have been split.
This is the commonest paragraph defect in this section: a single paragraph covering three figures.
- Propose the missing topic sentence where one is absent, and propose the split point where a
paragraph runs on.
Pass 3: figure captions
For each caption:
- Is it self-contained? Could someone in the field understand why the result matters from the
figure and caption alone, without the body text? This is what good journals expect.
- Does it merely name the axes? "Capacitance versus cycle number" is not a caption.
- Does it duplicate the body text? Overlap wastes space. Report what should live in which.
- Are panels labelled and explained, if the figure has them?
Pass 4: style
Report each hit with the sentence and a rewrite:
- Em dashes. Any
---, or -- outside a numeric range.
- Vague result language.
good, excellent, improved, significant without a value or a
test. Flag every instance; this is the section where it matters most.
- Stacked passive voice. Accumulates here more than anywhere else. Quote and rewrite.
- Hedge stacking.
it may be possible that this could suggest. Choose one hedge. Do not push
towards overclaiming: keep the hedge the evidence supports.
- Nominalization.
an increase in capacitance was observed for capacitance increased.
- Specificity. Any sentence that could appear unchanged in another paper.
- Sentence length. Any sentence whose opening is forgotten by its end.
- Monotonous openers. Long runs of subject-then-verb. Propose adverb, prepositional phrase,
dependent clause or infinitive alternatives.
- Redundancy, and anything the editor already assumes: that results were analysed, that samples
were prepared carefully, that measurements succeeded.
- Words to use sparingly.
careful, successfully, novel, preliminary.
increase / enhance / improve used interchangeably. They differ: increase is greater in
number or degree, enhance adds value to something already good, improve raises something from
not good to good.
- Ambiguity.
as or since where because is meant; pronouns with two possible referents,
which are rife here because of the density of nouns.
- Abbreviations defined at first use, and not stacked several to a short sentence.
- Numbers and units. Thin space between quantity and unit,
\% escaped, Figure~\ref{} with a
non-breaking space, ranges as -- not -.
Do not flag however, moreover, in contrast, nevertheless, in summary, or single
deliberate hedges such as may, suggests and is consistent with. Those are correct register.
Pass 5: connection to the introduction
Only if the introduction is available:
- Is every gap answered here? A gap promised and not addressed is the commonest structural
fault in a manuscript.
- Is every result here motivated there? A result the introduction never set up leaves the reader
unprepared.
- Do the state-of-the-art papers cited in the introduction reappear in the comparison sentences?
They usually should.
Deliver
- The information-class matrix.
- Structural verdict, most serious first.
- Topic sentence and paragraph boundary findings, with proposed sentences and split points.
- Caption findings.
- Style hits with rewrites.
- Connection mismatches.
- A rewritten version of the two or three weakest blocks, not the whole section: results and
discussion sections are long, and rewriting all of it buries the diagnosis. Say which blocks you
chose and why.
Then ask whether to apply. Never edit their files unasked.
Hard rules
- Never invent a value to fill a missing description. Report that the value is missing.
- Never supply a missing interpretation. Report that interpretation is absent and ask the
researcher for the explanation. Proposing a mechanism they did not propose is inventing science,
and it is the single most dangerous thing this skill could do.
- Never invent a comparison citation.
- Never emit an em dash.
- Separate the writing verdict from scientific merit. If a result looks scientifically weak, say so
in one line and move on.
- If the section is already good, say so and keep the review short.
1---2name: review-results-discussion3description: Review a results and discussion section from a writing perspective, labelling each result block against the four information classes (background, description, interpretation, comparison), checking topic sentences and paragraph boundaries, auditing figure captions for self-containment, and reporting style defects with rewrites. Use when asked to review, critique or improve a results or discussion section.4---56# /review-results-discussion78Diagnose the section the course calls the heart of the paper. The most common failures here are9structural rather than stylistic: results described but never interpreted, results interpreted but10never compared to prior work, and paragraphs that run on because nobody decided where they should11end.1213This reviews the writing, not the science. You do not judge whether the results are good, only14whether the text delivers them.1516## Before anything else17181. **Load the style rules.** Invoke `paper-writing-style` and read `references/human-voice.md`.192. **Lock the language.** Language of the user's first message, whole run. Rewrites are English.203. **Get the material.** The section, the figures and captions, the `.bib`, and the introduction if21 available, since the two must connect.2223## Pass 1: information classes, per result block2425Split the section into result blocks, one per figure, table or distinct finding. For each, mark26which of the four classes is present:2728| Class | Present? |29| :--- | :--- |30| Background, why this analysis matters | |31| Description, what the result shows, with values | |32| Interpretation, the explanation offered | |33| Comparison, how it relates to prior work, with citations | |3435Present this as a matrix: result blocks down the side, the four classes across the top. The gaps36are immediately visible, and the pattern of gaps is the finding.3738Then report, most serious first:39401. **Missing description with values.** A block that says a property "improved" or was "excellent"41 without numbers. This is the most serious defect available in this section.422. **Missing interpretation.** Description with no explanation is a data dump. Name each block.433. **Missing comparison.** No relation to prior work means the reader cannot tell whether the44 result is good. Very common, and cheap to fix.454. **Missing background** where a reader would not know why the analysis was run.465. **Results with no corresponding figure, table or text location**, or figures never discussed in47 the text. Both directions are defects.4849## Pass 2: topic sentences and paragraph boundaries5051For each paragraph:5253- **Identify the topic sentence.** Does the first sentence carry a topic (keyword) and a message54 (a claim about it)? Report paragraphs that open with something else, for example a bare methods55 statement or a figure reference with no claim.56- **Check every following sentence relates** to that topic or that message. Report strays.57- **Check the boundary.** A paragraph that changes topic or message halfway should have been split.58 This is the commonest paragraph defect in this section: a single paragraph covering three figures.59- **Propose the missing topic sentence** where one is absent, and propose the split point where a60 paragraph runs on.6162## Pass 3: figure captions6364For each caption:6566- **Is it self-contained?** Could someone in the field understand why the result matters from the67 figure and caption alone, without the body text? This is what good journals expect.68- **Does it merely name the axes?** "Capacitance versus cycle number" is not a caption.69- **Does it duplicate the body text?** Overlap wastes space. Report what should live in which.70- **Are panels labelled and explained**, if the figure has them?7172## Pass 4: style7374Report each hit with the sentence and a rewrite:7576- **Em dashes.** Any `---`, or `--` outside a numeric range.77- **Vague result language.** `good`, `excellent`, `improved`, `significant` without a value or a78 test. Flag every instance; this is the section where it matters most.79- **Stacked passive voice.** Accumulates here more than anywhere else. Quote and rewrite.80- **Hedge stacking.** `it may be possible that this could suggest`. Choose one hedge. Do not push81 towards overclaiming: keep the hedge the evidence supports.82- **Nominalization.** `an increase in capacitance was observed` for `capacitance increased`.83- **Specificity.** Any sentence that could appear unchanged in another paper.84- **Sentence length.** Any sentence whose opening is forgotten by its end.85- **Monotonous openers.** Long runs of subject-then-verb. Propose adverb, prepositional phrase,86 dependent clause or infinitive alternatives.87- **Redundancy**, and anything the editor already assumes: that results were analysed, that samples88 were prepared carefully, that measurements succeeded.89- **Words to use sparingly.** `careful`, `successfully`, `novel`, `preliminary`.90- **`increase` / `enhance` / `improve` used interchangeably.** They differ: `increase` is greater in91 number or degree, `enhance` adds value to something already good, `improve` raises something from92 not good to good.93- **Ambiguity.** `as` or `since` where `because` is meant; pronouns with two possible referents,94 which are rife here because of the density of nouns.95- **Abbreviations** defined at first use, and not stacked several to a short sentence.96- **Numbers and units.** Thin space between quantity and unit, `\%` escaped, `Figure~\ref{}` with a97 non-breaking space, ranges as `--` not `-`.9899Do **not** flag `however`, `moreover`, `in contrast`, `nevertheless`, `in summary`, or single100deliberate hedges such as `may`, `suggests` and `is consistent with`. Those are correct register.101102## Pass 5: connection to the introduction103104Only if the introduction is available:105106- **Is every gap answered here?** A gap promised and not addressed is the commonest structural107 fault in a manuscript.108- **Is every result here motivated there?** A result the introduction never set up leaves the reader109 unprepared.110- **Do the state-of-the-art papers cited in the introduction reappear** in the comparison sentences?111 They usually should.112113## Deliver1141151. The information-class matrix.1162. Structural verdict, most serious first.1173. Topic sentence and paragraph boundary findings, with proposed sentences and split points.1184. Caption findings.1195. Style hits with rewrites.1206. Connection mismatches.1217. **A rewritten version of the two or three weakest blocks**, not the whole section: results and122 discussion sections are long, and rewriting all of it buries the diagnosis. Say which blocks you123 chose and why.124125Then ask whether to apply. Never edit their files unasked.126127## Hard rules128129- **Never invent a value** to fill a missing description. Report that the value is missing.130- **Never supply a missing interpretation.** Report that interpretation is absent and ask the131 researcher for the explanation. Proposing a mechanism they did not propose is inventing science,132 and it is the single most dangerous thing this skill could do.133- **Never invent a comparison citation.**134- **Never emit an em dash.**135- Separate the writing verdict from scientific merit. If a result looks scientifically weak, say so136 in one line and move on.137- If the section is already good, say so and keep the review short.