Method

Score the draft before you improve its tone.

I mark a failure in the margin and leave the sentence alone until the set of marks is complete. Repair is allowed to touch only what a mark named. The six checks below are the score. The tags are the shorthand I write beside a line.

Six checks, in order
#CheckQuestionA fail
1Source of recordCan a reader name the system, packet, or document this sentence depends on?A confident claim with no record behind it.
2Load-bearing wordsDo the nouns and verbs that carry the action match the record?“Updated” or “aligned” where the record says installed, retired, or abandoned in place.
3Fake precisionIs every number, date, unit, and tolerance present in the source?A station, diameter, or date added because it makes the paragraph look like GIS.
4FollowabilityCould someone do the next action from this text alone?A verb with no object, no tool, and no stop.
5AudienceIs this written for the person who will use it?Mapper detail in a coordinator note, or a coordinator status where a mapper needed an attribute.
6Leftover AIDoes any sentence exist only to sound finished?Phrases that cannot be checked against a packet.

Draft, label, repair

  1. 01

    Draft

    The model writes, or a person does. I do not edit yet. I keep the draft visible so the marks have something to point at.

  2. 02

    Label

    I mark the margin with the tag that names the failure. If two tags apply, I write both. I do not rewrite the line in my head and call that a score.

  3. 03

    Repair

    I change the marked span. A softer rhythm that no check required stays as it was. Polish without a mark is how a second error gets in.

Margin tags

TERM
A word that does not match a defined system value or a term in the source.
INV
A fact the source does not contain.
SOR
No source of record named.
STEP
An action that cannot be carried out as written.
AUD
Written for the wrong reader.
PAD
Phrasing that only sounds finished.