Revision is the architect’s move. Editing is the painter’s move. Most writers do the painter’s move when the architect’s was needed. The work goes on. The wall stays in the wrong place.
This is the short version of what revision is for. The long version is in the companion essay. The short version is a checklist. Five things revision is for. One thing it is not. Use it the next time you read a draft that is not landing. Read the list. Find the right move.
1. Rewriting the spec, not editing the output#
Revision is not editing the output. It is going back to the spec and changing what the work is supposed to do. The spec is the contract between the writer and the reader. The spec is the contract between the writer and herself. Most failures are spec failures. Most writers respond to spec failures by editing the output. The output never gets fixed. The spec stays broken. The next draft has the same problem. The draft after that has the same problem. The discipline is to stop editing and rewrite the spec. The architect’s move. Not the painter’s.
2. Naming the spec failure, the broken section#
A draft that needs revision has signs. Vague section titles. A close that does not land. A middle section you cannot stop polishing. Ambiguity that two readers read two ways. None of these are sentence problems. They are spec problems. The fix is to name the broken section before doing any work. Once the section is named, the fix is procedural. Before the section is named, the fix feels impossible. Naming the broken section is half the revision. The other half is the rewrite. The model can do the rewrite once the section is named. The architect names. The model writes.
3. Restructuring into modules, cheap revision#
Monolithic sections try to do five things at once. None of them lands. Modular sections do one thing each. Each module can be lifted and dropped into a different essay. The same three modules anchor three different essays for three different audiences. The vertical changes. The system stays. Modular thinking is the architecture that makes revision cheap. A revised module costs an hour. A revised monolith costs a week. The model can rewrite one module at a time. The writer cannot rewrite a monolith without rebuilding the whole.
4. Letting the model audit, delegating the check#
The model can audit the draft against the spec faster than the writer. The model finds violations the writer would miss on pass four. The model has no fatigue. The model has no ego. The architect runs the audit. The writer reads what passes. Revision is delegating the audit to the model. The writer’s job is the spec. The model’s job is the audit. The output is the consequence. The audit is the gate. The gate is the writer’s. The architect names the standard. The model checks every line against it. The writer reads what survived the check.
5. Knowing when you are editing instead, polish is not craft#
If you are polishing sentences in section three because you want to feel like you are working, you are editing. The middle section will not change the argument no matter how polished it gets. Most polish is editing the wrong wall. Stop. Open the spec. Read what the section was supposed to do. If the section does not do it, the fix is not polish. The fix is revision. The polish comes after the spec is right. Polish before the spec is right is procrastination dressed as craft. Most of what looks like craft, in most published writing, is procrastination.
The one thing revision is not, better is a by-product#
Revision is not for making the draft better. Better is a by-product. Revision is for getting the spec right. When the spec is right, the draft is better. When the spec is wrong, no draft will be.
The painter polishes. The architect revises. The writer chooses which move to make. The choice is the architect’s discipline. Most writers do not know it is a choice.
This is also what the decision before the sentence means at the architect’s level. The decision is the spec. The sentence follows. Revision is the architect going back to the decision.
Most polish is editing the wrong wall. Most revision changes which wall the painter is asked to paint.
Choose.
