Tap a claim on the ring to put it at the centre.
← When two expert users argue over whether documentation is clear, that…
17 connected korrents · 17 moments from 12 Oct 2022 to 13 Oct 2026.
Everything filed under documentation
documentation
Everything filed under design
design
Everything filed under prompt injection
prompt injection
Everything filed under writing
writing
Everything filed under coding agents
coding agents Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same subject Read this 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. 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. Last stated 9 months ago
8 Jan 2026
JE
Julia Evans — holds since 2026-01-08 — tap for who they are
Same subject: A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation. — tap to centre the map on it A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation. Last stated 5 months ago
20 May 2026
AR
Alice Ryhl — holds since 2026-05-20 — tap for who they are
Same subject: AI agents can maintain kid-friendly interactive documentation that explains how game code works. — tap to centre the map on it AI agents can maintain kid-friendly interactive documentation that explains how game code works. Last stated a week ago
13 Oct 2026
AR
Armin Ronacher — holds since 2026-10-13 — tap for who they are
Same subject: AI-generated technical documentation is optimized for completing a sentence rather than for being understood by a human reader. — tap to centre the map on it AI-generated technical documentation is optimized for completing a sentence rather than for being understood by a human reader. Last stated 2 months ago
12 Aug 2026
VB
Vicki Boykis — holds since 2026-08-12 — tap for who they are
Same subject: Do not run a personal agent on a cheap or local model: weak models are gullible and easy to prompt-inject. — tap to centre the map on it Do not run a personal agent on a cheap or local model: weak models are gullible and easy to prompt-inject. Last stated 8 months ago
12 Feb 2026
PS
Peter Steinberger — holds since 2026-02-12 — tap for who they are
Same subject: Documentation should be written for AI coding agents to understand and modify software, not only for humans. — tap to centre the map on it Documentation should be written for AI coding agents to understand and modify software, not only for humans. Last stated 3 months ago
22 Jul 2026
SS
Salvatore Sanfilippo — holds since 2026-07-22 — tap for who they are
Same subject: Examples in documentation should be compiled and run as tests, so that changing the code breaks the docs instead of quietly outdating them. — tap to centre the map on it Examples in documentation should be compiled and run as tests, so that changing the code breaks the docs instead of quietly outdating them. Last stated 5 months ago
20 May 2026
AR
Alice Ryhl — holds since 2026-05-20 — tap for who they are
Same subject: Good documentation is produced by effort, not by tooling that keeps code and docs together — tap to centre the map on it Good documentation is produced by effort, not by tooling that keeps code and docs together Last stated 9 months ago
18 Jan 2026
HH
Hamel Husain — holds since 2026-01-18 — tap for who they are
Same subject: If you will write a huge markdown file so an agent has context, you should have written the documentation that gives a human the same context. — tap to centre the map on it If you will write a huge markdown file so an agent has context, you should have written the documentation that gives a human the same context. Last stated 5 months ago
3 Jun 2026
KH
Kelsey Hightower — holds since 2026-06-03 — tap for who they are
Same subject: For agents built on Claude Fable 5.1, it is in practice safe for now to assume they will not get prompt injected. — tap to centre the map on it For agents built on Claude Fable 5.1, it is in practice safe for now to assume they will not get prompt injected. Last stated 2 months ago
4 Sept 2026
ZM
Zvi Mowshowitz — holds since 2026-09-04 — tap for who they are
Same subject: Prompt injection can be caught by watching the neurons that fire when it happens, so a defence no longer depends on the model reporting the attack. — tap to centre the map on it Prompt injection can be caught by watching the neurons that fire when it happens, so a defence no longer depends on the model reporting the attack. Last stated 3 months ago
27 Jul 2026
BC
Boris Cherny — holds since 2026-07-27 — tap for who they are
Same subject: Prompt injection has no equivalent of parameterized queries: there is no reliable way to tell a language model which text is data and which is instructions. — tap to centre the map on it Prompt injection has no equivalent of parameterized queries: there is no reliable way to tell a language model which text is data and which is instructions. Last stated 7 months ago
19 Mar 2026
SW
Simon Willison — holds since 2026-03-19 — tap for who they are
Same subject: A $1,299, 100-gram pair of slip-on glasses seems far more enticing than a $3,699, 700-gram headset strapped to the face. — tap to centre the map on it A $1,299, 100-gram pair of slip-on glasses seems far more enticing than a $3,699, 700-gram headset strapped to the face. Last stated 4 weeks ago
24 Sept 2026
MS
M.G. Siegler — holds since 2026-09-24 — tap for who they are
Same subject: A baby-step version of eval-driven design is to sketch out 10 to 20 hero flows and run the feature or interaction through them to see where it falls apart. — tap to centre the map on it A baby-step version of eval-driven design is to sketch out 10 to 20 hero flows and run the feature or interaction through them to see where it falls apart. Last stated a month ago
9 Sept 2026
EB
Ed Bayes — holds since 2026-09-09 — tap for who they are
Same subject: A blank chat box is lazy: it violates the first rule of a good user experience, that it is obvious what you can do. — tap to centre the map on it A blank chat box is lazy: it violates the first rule of a good user experience, that it is obvious what you can do. Last stated a year ago
12 May 2025
JZ
Julie Zhuo — holds since 2025-05-12 — tap for who they are
Same subject: A browser that answers with generated prose instead of links is not a web browser but an anti-web browser, and it hides that substitution from the person using it. — tap to centre the map on it A browser that answers with generated prose instead of links is not a web browser but an anti-web browser, and it hides that substitution from the person using it. Last stated a year ago
22 Oct 2025
AD
Anil Dash — holds since 2025-10-22 — tap for who they are
Same subject: A first draft is necessarily bad, and that is exactly why one has to be written. — tap to centre the map on it A first draft is necessarily bad, and that is exactly why one has to be written. Last stated 4 years ago
12 Oct 2022
AK
Austin Kleon — holds since 2022-10-12 — tap for who they are
Same subject: A first draft should not be graded good or bad; it is only the material that taste then gets to act on. — tap to centre the map on it A first draft should not be graded good or bad; it is only the material that taste then gets to act on. Last stated 3 months ago
6 Aug 2026
GS
George Saunders — holds since 2026-08-06 — tap for who they are
At the centre
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.
Holds Read this korrent →
A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation.
Holds
AI agents can maintain kid-friendly interactive documentation that explains how game code works.
Holds
AI-generated technical documentation is optimized for completing a sentence rather than for being understood by a human reader.
Holds
Do not run a personal agent on a cheap or local model: weak models are gullible and easy to prompt-inject.
Holds
Documentation should be written for AI coding agents to understand and modify software, not only for humans.
Holds
Examples in documentation should be compiled and run as tests, so that changing the code breaks the docs instead of quietly outdating them.
Holds
Good documentation is produced by effort, not by tooling that keeps code and docs together
Holds
If you will write a huge markdown file so an agent has context, you should have written the documentation that gives a human the same context.
Holds
For agents built on Claude Fable 5.1, it is in practice safe for now to assume they will not get prompt injected.
Holds
Prompt injection can be caught by watching the neurons that fire when it happens, so a defence no longer depends on the model reporting the attack.
Holds
Prompt injection has no equivalent of parameterized queries: there is no reliable way to tell a language model which text is data and which is instructions.
Holds
A $1,299, 100-gram pair of slip-on glasses seems far more enticing than a $3,699, 700-gram headset strapped to the face.
Holds
A baby-step version of eval-driven design is to sketch out 10 to 20 hero flows and run the feature or interaction through them to see where it falls apart.
Holds
A blank chat box is lazy: it violates the first rule of a good user experience, that it is obvious what you can do.
Holds
A browser that answers with generated prose instead of links is not a web browser but an anti-web browser, and it hides that substitution from the person using it.
Holds
A first draft is necessarily bad, and that is exactly why one has to be written.
Holds
A first draft should not be graded good or bad; it is only the material that taste then gets to act on.
Holds