Acknowledge Before Revise

Heart

Before proposing any revision to a contribution, name what the contribution added. The curator's first move in any curation pass is acknowledgment — what node the contribution introduced, what gap it closed, what edge it made tractable, what distinction it surfaced. Only then does revision enter the conversation. The sequence is the move; reversing it (revise first, acknowledge later) does not produce the same outcome.

Problem

Revision that arrives without acknowledgment is experienced by the contributor as overwriting, even when the revision is good. The contributor's work disappears into the revised form without a trace that the work was received, considered, and built upon — only the resulting revision is visible, and the resulting revision reads as the curator's authorship. The contributor's relationship to the graph moves from "I contributed something that became part of this" to "something I wrote was changed," which are structurally different experiences.

The default curator posture is revision-first. The curator opens a node, sees what needs to change, and changes it. Acknowledgment feels like friction — an extra step before the work can be done. In a single-author garden, the friction produces no cost (the author is both the contributor and the curator). In a multi-contributor graph, the absence produces the contributor-erasure dynamic that [[Pride and Humility Are Both Cultivable]] names.

The difficulty is habit, not mechanics. Once the curator has internalized acknowledge-first, the acknowledgment is a sentence or two in a curation-pass note. The craft this Pattern teaches is fighting the revision-first habit at the moment the curator opens a node to revise.

Forces

Solution

In every curation pass, before proposing or making any revision to a contribution:

  1. Name what the contribution introduced. One or two sentences identifying the specific addition — the new node, the new predicate, the new annotation, the new edge, the surfaced distinction. Be specific enough that a reader who does not know the contribution's history can tell what arrived.
  2. Name what the contribution addressed. If the contribution closed a gap, resolved an Open Question, corrected a drifted account, or added a missing edge, name that. The acknowledgment is thicker than "X added a node"; it is "X added a node that grounds the previously-ghost Aspiration at the contributor-transition layer."
  3. Then revise. Propose the revision, make the edit, or note the drift correction. The revision sits inside a recognized contribution; the contributor sees both their work and the revision's relation to it.
  4. Capture the acknowledgment in the curation-pass record. The acknowledgment is not only a moment in a conversation; it is a durable part of the curation-pass output. Contributors reading the output see what the curator recognized in each contribution, not only what the curator changed.

The sequence's order matters. Acknowledging after revising — a curation-pass note that describes the revision then adds "and X's original contribution was valuable" — does not produce the same contributor experience. The post-hoc acknowledgment reads as mitigation of the revision rather than as recognition of the contribution.

Consequences

Instances

Also Known As

Relations