Tap a claim on the ring to put it at the centre.
← Examples in documentation should be compiled and run as tests, so that…
17 connected korrents · 15 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
Everything filed under compilers
compilers 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: Examples in documentation should be compiled and run as tests, so that changing the code breaks the docs instead of quietly outdating them. 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 4 months ago
20 May 2026
AR
Alice Ryhl — holds since 2026-05-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 documentation. 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: 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 gives a human the same context. 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 noise they remove is the noise that would otherwise swallow the answer. Last stated 6 years ago
1 May 2020
DL
Derek Lowe — holds since 2020-05-01 — tap for who they are
Same subject: Stop writing documentation for people: a library should ship markdown for agents, which then explain it to whoever asks. — tap to centre the map on it 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: 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 actually find unclear documentation is to test it on real readers, not to have experts argue about wording. Last stated 8 months ago
8 Jan 2026
JE
Julia Evans — holds since 2026-01-08 — tap for who they are
Same subject: A compiler that names every place a change breaks turns refactoring into fixing errors until the compiler stops shouting. — tap to centre the map on it A compiler that names every place a change breaks turns refactoring into fixing errors until the compiler stops shouting. Last stated 4 months ago
20 May 2026
AR
Alice Ryhl — holds since 2026-05-20 — 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 practically be assumed safe from successful injection attacks. 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 the model reporting the attack. 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 you where you are wrong. 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 by spawning agents, and the whole loop scales on one thing, compute. 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 whether more of it helps or ruins the thing. 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 of genius — which is an org design problem. 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
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 RyhlRead 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
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
Stop writing documentation for people: a library should ship markdown for agents, which then explain it to whoever asks.
Holds
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 compiler that names every place a change breaks turns refactoring into fixing errors until the compiler stops shouting.
Holds AR Alice Ryhl
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