The note is the unit of work

Watch anyone use a document tool for real work and you will see the same ten seconds happen over and over. They read a paragraph, they know something is wrong with it, and then they stop — because saying so costs more than thinking it.

They can leave a comment, which nobody will read again. They can open a ticket, which means retyping the paragraph, the context and the reason. Or they can say nothing, which is what most people do most of the time.

The retyping tax

We measured this at three companies before we wrote a line of Margin. The median time from noticing a problem in a document to filing something a colleague could act on was eleven minutes. Not eleven minutes of work — eleven minutes of translation. Copying the paragraph. Explaining where it came from. Guessing who owns it.

Nine times out of ten the person gave up before the eleven minutes were done.

A comment is a thought with nowhere to go. A ticket is a thought that has been retyped by someone who has already lost interest.

What a note carries

So a note in Margin is not a comment. It is a first-class object that carries four things with it, always:

• the block it was written beside, and every edit that block has had since
• the sources that block cites — the thread, the pull requests, the roadmap item
• who wrote it, and who has read it
• its state, which is open until something closes it

Because it carries those, a note can be assigned without being retyped. It can appear on a board without being copied. An agent can pick it up and already know what it is about. And when the work lands, the note closes against the paragraph that started it, so the next person to read the page sees the argument as well as the outcome.

What changed

The number we care about is how many noticed problems become filed work. Before Margin, at the three companies we measured, it was under a fifth. Six months in, it is a little over four fifths.

The interesting part is not that people file more. It is that they read more carefully, because reading carefully is now worth something. When the cost of saying this is wrong falls to one keystroke, people say it — and the writing gets better long before the agent ever gets involved.