Revision: from diagnosis to a new version

How to use

Keep a draft copy before editing. Diagnose a specific passage, test a change and reread related passages. The responses below are hypothetical examples, not workshop or audience research results.

Worked record

Your revision record

• Starting version:
• Passage or location:
• Intended effect:
• Observed response, separate from your interpretation:
• Possible cause:
• Alternative A and its cost:
• Alternative B and its cost:
• Chosen change:
• Other affected passages:
• Rereading result:
• What to preserve:

A sentence comparison

Draft: “She took the thing and told him that she was very sorry.”

Alternative: “Joana held the folder. ‘I should have told you sooner.’”

The alternative identifies object and speaker and expresses regret through a specific line. It would still be insufficient if readers did not know what Joana had concealed. Sentence clarity also depends on preparation.

A reading invitation

“Would you be willing to read this story and tell me when you understood why Joana avoids asking for help? I don’t need sentence-by-sentence corrections yet. If possible, also point out a passage that worked for you.”

Adapt the request and agree on availability before sending. Keep responses yourself; this resource sends no messages.

Revise the problem that changes the story first

If an ending feels unearned, swapping adjectives will not establish its setup. Identify the failed effect first: an unclear decision, an insignificant object, a solution based on new information or a scene repeating what we know. Then choose a change that addresses a plausible cause.

“Rui finds the folder by chance and Joana learns to ask for help” does not make cooperation cause the solution. One revision connects the folder’s size to the window record and requires Joana to supply that detail. This affects passages before and after discovery, not just a moral at the end.

Outline what the draft actually does, even if your plan differed. Keep a copy and revise one problem at a time. Recheck dependencies: making the folder small removes its reason for being outside the box. A revision must preserve the connections it relies on.

Diagnosis, hypothesis and consequences

Writing Excuses episode 10.44 presents differing revision practices and separates broad problems from polishing. An unsatisfying ending may depend on earlier preparation. Rather than scoring quality through a formula, we can examine that relationship with invented versions.

Alternative draft: “Joana had searched for the map all morning. Rui tripped over a box and the folder fell out. She thanked him and realized the importance of asking for help.” The last sentence assigns a change the events do not demonstrate. Asking for help did not find the map; a stumble did. Replacing “realized” with “deeply understood” changes no causal relationship.

Precise diagnosis: the conclusion about cooperation is unsupported by the resolution. This is more useful than “the ending is weak” because it allows competing revision paths.

No path is inherently best. The published version chooses the second to connect the search with difficulty accepting help. The first could serve a different story well. Revision does not require forcing every narrative into the same arc.

Building the chosen revision

1. Prepare access to the solution: S03 establishes the transfer sheets. S08 does not invent a convenient resource at the moment it is needed.
2. Explain why the available information is insufficient: Joana searches by her mother’s name; the useful entry uses size and position. Their mismatch explains the initial failure.
3. Connect omission to choice: S05 offers a chance to describe the folder. “Ordinary” protects Joana’s attempt to appear in control while obstructing assistance.
4. Give memory two functions: S06 recalls both a wide sheet and time with her mother. It changes what Joana can say and why saying it matters.
5. Make the choice consequential: S07–S08 connect admission to the right record. The map does not fall from the ceiling; a reconstructible chain reveals it.
6. Preserve an effect after resolution: S10 updates the entry; S12 shows cooperation through a small action. No permanent personality transformation is claimed.

These describe this case, not a mandatory six-stage recipe. An atmospheric piece might seek recurrence or contrast instead of this progression. It still needs to sustain the experience it offers.

Local edits can break distant relationships

Suppose you cut S06 to accelerate the story. The search moves faster, but loses the trigger that recalls size and part of the mother-daughter connection. A shorter replacement could be: “Her mother asked about the crooked street. Joana remembered the paper stretching across the table.” It keeps two functions while reducing texture and intimacy.

Now move “cabinet B” into S02 and explicitly let Joana see it. Her subsequent search might seem artificial or careless in a different way. You would need to show why she ignores an answer she has, or remove her access to it. Reordering changes logic even when individual sentences remain correct.

Evaluate without inventing audience results

Reread for evidence: does the choice affect the search, was the location prepared, and does the ending recall something recognizable? If someone agrees to read, ask why the folder was found. “Rui got lucky” and “Joana finally explained which folder” would point to different readings worth investigating.

These hypothetical responses are not actual reader results. They identify what to observe. A reader can understand the causality and still dislike the story; another may enjoy its voice despite a gap. Record comprehension, emotional effect and preference separately. Revision means choosing among effects and costs, not accumulating changes until everyone seems to approve.

Request feedback that helps you decide

“Was it good?” often produces little you can use. Ask where the reader felt curious, lost or indifferent, and what they expected next. Agree whether you want a whole-story response or comments on one passage rather than assuming availability for a full edit.

Hypothetical response: “Why didn’t she ask Rui immediately?” Before adding a long explanation, check whether S04 and S05 make her embarrassment perceptible. A gesture may be missing, or the motivation may arrive too late. The reader reports an experience; the solution remains your decision.

Readers can disagree about a pause. Compare your intention, their reading context and the passages they cite. Repeated responses can guide investigation without turning taste into objective error. Record what works so another change does not erase it.

Control rhythm through selection and sentences

Pacing involves space, order and wording, not just short sentences. The inventory in S05 moves through the search quickly. The string’s knot in S09 receives a slow gesture: after urgency, the object becomes personal again.

Compare “She opened the folder and recognized the map” with “The string gave way. Joana opened the folder. The crooked street crossed the paper.” The second stretches recognition. It may suit an emotional center or feel excessive if the moment is already resolved.

Read a passage and note where attention accelerates, rests or wanders. Cut redundant explanation before removing every pause. Unrelenting speed removes contrast; constant detail can dilute decisions. Judge by the passage’s intended effect.

Edit sentences while preserving voice

Once central relationships work, inspect subjects, verbs, repetition and imagery. “She put the thing there and he took it” makes readers guess. “Joana set the folder on the table; Rui held down the map’s edge” makes the action visible. Precision often helps more than an elaborate synonym.

Practice draft: “She felt a very strong feeling of shame and was extremely embarrassed.” Alternative: “Joana picked up the roll. ‘An ordinary folder.’” The alternative stages evasion, but readers still need context. Removing a named emotion does not automatically create understanding.

Read aloud, check pronoun references and look for purposeless repetition. Keep repetition that carries meaning: the crooked street connects memory and ending. Punctuation guides reading; register and rhythm help form the voice. A correction tool can suggest possibilities without deciding your style.

Check facts, objects and information

Make a small continuity table. Here: Joana entered 17; the folder was large; it rested by the window; Rui moved it to B; the second sheet records that move. Readers need enough information to reconstruct the relationship, not every detail in the opening paragraph.

Track who knows what. Rui knows the transfer but initially does not know which folder Joana means. Joana knows the donor’s name and takes time to recall the location. If Rui identified the map earlier and pretended otherwise, their relationship would change.

For historical or technical fiction, separate acknowledged invention from verifiable facts. Research facts supporting the action; convincing prose does not validate a procedure. This fictional memory room is not a lesson in archival conservation. Research an actual institution’s practices before attributing procedures to it.

Organize versions and comments without losing the original

Paper or a simple editor is enough to write. You need to find the text, distinguish versions and undo choices. “story-v01,” “story-v02” and a brief change note can be sufficient; keep a separate copy away from the working device.

In Writer, keep an ODT manuscript and use tracked changes when discussing edits: Edit → Track Changes → Manage lets you review changes to accept or reject. Menu names can vary. A reading PDF does not replace the editable original. Check paragraphs and comments when exchanging DOCX with another editor.

Obsidian suits local Markdown notes about characters, scenes and research. Put the .md materials in a folder and open it as a vault. Sync and Publish are optional services; local writing does not require them. Linked notes are not equivalent to Writer’s editorial tracking. Choose for the work you need to do.

Treat an AI reading as a hypothesis

If you use AI, give it a bounded task: “Read this passage and identify where it is unclear who knows the folder’s location. Cite the sentence supporting each observation. Do not rewrite.” This gives you more checkable hypotheses than “make my story amazing.” Do not submit another person’s manuscript or confidential material without permission.

Suppose a response claims Rui hid the map. S03 and S08 show a recorded transfer, not proof of sabotage. Reject the claim or investigate it as a possible reading instead of adopting it as a story fact. A confident tone can accompany a mistaken interpretation.

For alternatives, request two openings with different effects but the same premise, then compare their promises. Decide which wording and meanings to keep. Do not delegate originality assessment, fact verification or cultural understanding to an unchecked response. The purpose is to see options, not obtain a quality score.

References

• Diagnosing a revision
• Building voices in dialogue
• Structuring narrative time
• Third person limited and proximity
• Review changes in Writer
• LibreOffice
• Local notes and connections
• Obsidian access conditions
• Obsidian platforms

Sources checked 2026-09-26.