korrents

A korrentour readingWhat is a korrent?

When two expert users argue over whether documentation is clear, that debate is unproductive — the way to actually find unclear documentation is to test it on real readers, not to have experts argue about wording.

Drawn from what Julia Evans said

In the currentdocumentation
Interesting
Keep this without saying you believe it. Private, and never counted.

What Julia Evans actually said

Their words, word for word, each linked to where it was said. They did not write this page.

  1. Julia Evans I don’t think this is very productive (expert users of a piece of software are notoriously bad at being able to tell if an explanation will be clear to non-experts), so I needed to find a way to identify problems with the man pages that was a little more evidence-based.

    Writes jvns.ca, a blog explaining networking

    Their wordsI don’t think this is very productive (expert users of a piece of software are notoriously bad at being able to tell if an explanation will be clear to non-experts), so I needed to find a way to identify problems with the man pages that was a little more evidence-based.

    ↗A data model for Git (and other docs updates)jvns.ca

First recorded here 8 Jan 2026 · How quotes work · Something wrong? Tell us

Do you hold this korrent?

Sign in to record that you hold this, with a confidence number of your own.

Related korrents

Our reading — they may agree, disagree or merely touch the same thing.

See this on the map →