Tap a claim on the ring to put it at the centre.
← Stop writing documentation for people: a library should ship markdown…
17 connected korrents · 16 moments on record from 1 May 2020 to 4 Sept 2026.
Everything filed under documentation
documentation
Everything filed under AI agents
AI agents
Everything filed under design
design
Everything filed under prompt injection
prompt injection 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: Stop writing documentation for people: a library should ship markdown for agents, which then explain it to whoever asks. Stop writing documentation for people: a library should ship markdown for agents, which then explain it to whoever asks. Last stated 6 months ago
20 Mar 2026
AK
Andrej Karpathy — holds since 2026-03-20 — 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… Last stated 4 months ago
20 May 2026
AR
Alice Ryhl — holds since 2026-05-20 — 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 7 months ago
12 Feb 2026
PS
Peter Steinberger — holds since 2026-02-12 — 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… Last stated 4 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 8 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… Last stated 3 months ago
3 Jun 2026
KH
Kelsey Hightower — holds since 2026-06-03 — tap for who they are
Same subject: Standardised manufacturing and documentation cannot be skipped when a drug is given to human beings, because the noise they remove is the noise that would otherwise swallow the answer. — tap to centre the map on it Standardised manufacturing and documentation cannot be skipped when a drug is given to human beings, because the… Last stated 6 years ago
1 May 2020
DL
Derek Lowe — holds since 2020-05-01 — tap for who they are
Same subject: 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. — tap to centre the map on it When two expert users argue over whether documentation is clear, that debate is unproductive — the way to… Last stated 8 months ago
8 Jan 2026
JE
Julia Evans — holds since 2026-01-08 — tap for who they are
Same subject: A team can stop reading the code it ships, but only by first working out how its agents are to prove that what they wrote actually works. — tap to centre the map on it A team can stop reading the code it ships, but only by first working out how its agents are to prove that what… Last stated 6 months ago
19 Mar 2026
SW
Simon Willison — holds since 2026-03-19 — tap for who they are
Same subject: Auto-mode does not yet convincingly fix prompt-injection risk for coding agents. — tap to centre the map on it Auto-mode does not yet convincingly fix prompt-injection risk for coding agents. Last stated 4 weeks ago
8 Aug 2026
SW
Simon Willison — holds since 2026-08-08 — tap for who they are
Same subject: Current prompt-injection defenses for AI agents (such as auto mode) are now reliable enough that agents can practically be assumed safe from successful injection attacks. — tap to centre the map on it Current prompt-injection defenses for AI agents (such as auto mode) are now reliable enough that agents can… Last stated 3 days 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… Last stated a month ago
27 Jul 2026
BC
Boris Cherny — holds since 2026-07-27 — tap for who they are
Same subject: A handful of AI agents is not a handful of colleagues, because agents agree with you constantly and colleagues tell you where you are wrong. — tap to centre the map on it A handful of AI agents is not a handful of colleagues, because agents agree with you constantly and colleagues tell… Last stated 6 months ago
22 Mar 2026
NF
Nicole Forsgren — holds since 2026-03-22 — tap for who they are
Same subject: After pre-training, post-training and test-time scaling, the fourth scaling law is agentic: multiplying AI by spawning agents, and the whole loop scales on one thing, compute. — tap to centre the map on it After pre-training, post-training and test-time scaling, the fourth scaling law is agentic: multiplying AI… Last stated 6 months ago
23 Mar 2026
JH
Jensen Huang — holds since 2026-03-23 — tap for who they are
Same subject: Agent autonomy is a capability, not a product direction: what the person is actually trying to do decides whether more of it helps or ruins the thing. — tap to centre the map on it Agent autonomy is a capability, not a product direction: what the person is actually trying to do decides… Last stated 3 weeks ago
14 Aug 2026
SP
Sunil Pai — holds since 2026-08-14 — 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 company deserves everyone in it, the chief executive included, to spend as much time as possible in their zone of genius — which is an org design problem. — tap to centre the map on it A company deserves everyone in it, the chief executive included, to spend as much time as possible in their zone… Last stated a year ago
23 Mar 2025
RV
Rahul Vohra — holds since 2025-03-23 — tap for who they are
Same subject: A computer meant for anyone has to be understandable without a manual, and it has to be friendly. — tap to centre the map on it A computer meant for anyone has to be understandable without a manual, and it has to be friendly. Last stated 3 weeks ago
14 Aug 2026
SK
Susan Kare — holds since 2026-08-14 — tap for who they are
At the centre
Stop writing documentation for people: a library should ship markdown for agents, which then explain it to whoever asks.
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 AR Alice Ryhl
Do not run a personal agent on a cheap or local model: weak models are gullible and easy to prompt-inject.
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 AR Alice Ryhl
Good documentation is produced by effort, not by tooling that keeps code and docs together
Holds HH Hamel Husain
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 KH Kelsey Hightower
Standardised manufacturing and documentation cannot be skipped when a drug is given to human beings, because the noise they remove is the noise that would otherwise swallow the answer.
Holds DL Derek Lowe
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 JE Julia Evans
A team can stop reading the code it ships, but only by first working out how its agents are to prove that what they wrote actually works.
Holds
Auto-mode does not yet convincingly fix prompt-injection risk for coding agents.
Holds
Current prompt-injection defenses for AI agents (such as auto mode) are now reliable enough that agents can practically be assumed safe from successful injection attacks.
Holds ZM Zvi Mowshowitz
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
A handful of AI agents is not a handful of colleagues, because agents agree with you constantly and colleagues tell you where you are wrong.
Holds NF Nicole Forsgren
After pre-training, post-training and test-time scaling, the fourth scaling law is agentic: multiplying AI by spawning agents, and the whole loop scales on one thing, compute.
Holds JH Jensen Huang
Agent autonomy is a capability, not a product direction: what the person is actually trying to do decides whether more of it helps or ruins the thing.
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 JZ Julie Zhuo
A company deserves everyone in it, the chief executive included, to spend as much time as possible in their zone of genius — which is an org design problem.
Holds RV Rahul Vohra
A computer meant for anyone has to be understandable without a manual, and it has to be friendly.
Holds SK Susan Kare