Engine Room
Transparent notes on how PasteLint’s deterministic revision engine changes.
Directness Without False Certainty
Why SecondDraft stopped treating qualified language as something to delete.
The defect
A cleaner sentence can still become less accurate.
That was happening in SecondDraft’s Direct mode. Words such as may, probably, and I think were sometimes treated as hesitation and removed. The result sounded firmer—but it also said something different.
Direct now follows a narrower rule: simplify a supported request when it is safe, but preserve the original level of certainty, who is responsible, and whether the sentence offers a recommendation or states a requirement.
The old behavior
Four small edits were changing what the sentence meant.
Direct mode could change may to can and remove probably, I think, and It seems that. Each edit looked small. Each could make the revised sentence claim more than the original.
The problem was not that every cautious phrase deserved to stay. It was that the editor could not tell whether those words were empty padding or essential meaning.
Possibility versus capability
May and can are not interchangeable.
Concept Illustration · Does not execute PasteLint
Possibility is not capability
Original sentence
The event may be canceled if severe weather continues.
Possible revision
The event can be canceled if severe weather continues.
Decision
Do not apply this revision. Preserve may.
Why this decision was made
May describes an uncertain outcome here. Can may describe ability, authority, or permission, so the proposed substitution would change the claim.
- Preserved
- Possibility, the severe-weather condition, and the event remain intact.
- Changed
- No wording changes in this example.
- Intentionally unchanged
- The sentence remains unchanged because the proposed edit would convert possibility into capability.
Text summary: Original: The event may be canceled if severe weather continues. Possible revision: The event can be canceled if severe weather continues. Decision: do not apply the revision; preserve may because possibility is not capability.
Limitation: This illustration explains one editorial distinction and does not execute PasteLint.
Complete concept illustration available without interaction.
“The event may be canceled” describes an uncertain outcome. “The event can be canceled” can describe ability or permission. The sentences are close in length, but they do not make the same claim.
Probability versus certainty
Removing probably can overstate the evidence.
Source: The launch will probably be delayed if approval arrives after Tuesday.
Unsafe rewrite: The launch will be delayed if approval arrives after Tuesday.
Current Direct output: The launch will probably be delayed if approval arrives after Tuesday.
Removing probably does not merely make the sentence shorter. It turns a likely delay into a definite one.
Attributed judgment versus fact
“I think” can be part of the meaning.
Source: I think the revised menu is ready for review.
Unsafe rewrite: The revised menu is ready for review.
Current Direct output: I think the revised menu is ready for review.
In workplace writing, I think can show that a statement is someone’s assessment—not a verified fact. SecondDraft cannot check whether the menu is actually ready, so it should not write as though it has.
Negated possibility
Two small words can change the entire situation.
Source: The library may not approve the revised menu.
Unsafe rewrite: The library can not approve the revised menu.
Current Direct output: The library may not approve the revised menu.
“May not approve” means approval is uncertain. “Can not approve” suggests the library lacks the ability or authority to approve it. The difference changes what the reader believes is possible.
A supported request
What Direct mode can safely change.
Source: We were hoping you could confirm whether the library may not approve the menu.
Current Direct output: Please confirm whether the library may not approve the menu.
Here the extra request framing can go. The words inside the request cannot. The revision still asks about the library, the menu, and the possibility that approval may not happen.
The result is more direct without becoming more certain.
- Tone
- Direct
- Length
- Keep similar
- Structure
- Reflow off
Change the frame. Preserve the claim.
Recommendation strength
A suggestion is not a command.
Source: The main point is that we should review the dates before recording.
Current focused output: We should review the dates before recording.
The opening announcement can be removed, but we, should, and before recording still matter. Dropping should would turn a recommendation into an instruction. Dropping we would change who is responsible.
What changed
A safer editor sometimes leaves the sentence alone.
- Direct no longer automatically changes
maytocanor removesprobably,I think, andIt seems that. - Supported requests keep words that express uncertainty, conditions, and responsibility.
- The focused main-point edit keeps
we should, while testeda.m.andp.m.forms remain intact during sentence cleanup.
Regression coverage
What SecondDraft now leaves intact.
- Possibility
- Remains possibility
- Probability
- Remains probability
- Recommendation
- Remains recommendation
- Negation
- Survives the revision
- Conditions
- Survive the revision
- Actor and responsibility
- Remain assigned
- Protected values
- Remain fixture-backed
Coverage also includes
- Possibility, permission, likelihood, judgment, recommendations, requirements, conditions, and negation.
- Quoted, technical, policy, IVR, contractual, and numeric language, plus protected dates and contact details.
- Already-direct requests and unsupported constructions that should remain unchanged.
Engine principle
Sometimes the right edit is no edit.
If removing a cautious word would change what the writer claims, leaving the sentence alone is the more accurate choice.
Under the hood
Narrow rules, checked against specific examples.
SecondDraft runs in the browser and uses a limited set of tested rules. For supported requests, it checks the final text before returning an edit note. SD-CLARITY-002 applies only to those request openings. The tests cover specific examples; they do not give the editor a human understanding of every sentence.
Takeaway
Change the frame. Preserve the claim.
Compare a qualified statement with a supported request and review exactly what the engine changes.
Continue the Record
The reasoning belongs to a larger public record.
-
Editor’s Desk
The Record Behind Product Transparency
Why this safeguard belongs in a durable public record of product reasoning, evidence, and limits.
Related Principles
- Meaning Preservation
- Verification Before Publication
- Editorial Transparency
Related reading
More notes on visible, bounded revision.
Editor’s Desk companion
Clearer Is Not More Certain
A practical test for deciding when a qualifier carries meaning rather than clutter.
Field note
The Cleanup Pass Is Where Voice Survives
Why reviewable edits help the writer keep ownership of the final text.
Editor’s Desk
Filler Openings Make AI Drafts Feel Unfinished
Why removing empty setup can help when the useful meaning remains intact.
Framework
Text Readiness Framework
Place mechanical cleaning, editorial revision, and preparation in the right order.
Journal
Text Preparation Journal
Read more field notes, editing rules, and Engine Room reports.