korrents

On the map

Tap a claim on the ring to put it at the centre.

← Good documentation is produced by effort, not by tooling that keeps code and docs together

17 connected korrents · 17 moments from 29 Sept 2018 to 13 Oct 2026.

Everything filed under documentation documentation Everything filed under prompt injection prompt injection Everything filed under simplicity simplicity Everything filed under writing writing Everything filed under coding agents coding agents Everything filed under design design Same subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subject Read this korrent: Good documentation is produced by effort, not by tooling that keeps code and docs together Good documentation is produced by effort,not by tooling that keeps code and docstogether Last stated 9 months ago 18 Jan 2026 HH Hamel Husain — holds since 2026-01-18 — 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 describethe feature as though it alreadyexisted — once as a tutorial andonce 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-friendlyinteractive documentation thatexplains 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 documentationis optimized for completing asentence rather than for beingunderstood 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 acheap or local model: weak modelsare gullible and easy toprompt-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 forAI coding agents to understand andmodify software, not only forhumans. 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 becompiled and run as tests, so thatchanging the code breaks the docsinstead 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: 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 markdownfile so an agent has context, youshould have written thedocumentation that gives a human thesame context. Last stated 5 months ago 3 Jun 2026 KH Kelsey Hightower — holds since 2026-06-03 — tap for who they are Same subject: Letting customers pin old runtime versions would undo part of the promise of serverless: that developers should not have to worry about updating their stack. — tap to centre the map on it Letting customers pin old runtimeversions would undo part of thepromise of serverless: thatdevelopers should not have to worryabout updating their stack. Last stated 5 years ago 19 Oct 2021 KV Kenton Varda — holds since 2021-10-19 — 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 Fable5.1, it is in practice safe for nowto assume they will not get promptinjected. 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 bywatching the neurons that fire whenit happens, so a defence no longerdepends on the model reporting theattack. 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 equivalentof parameterized queries: there isno reliable way to tell a languagemodel which text is data and whichis 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 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 withgenerated prose instead of links isnot a web browser but an anti-webbrowser, and it hides thatsubstitution from the person usingit. Last stated 12 months 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 tobe 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 gradedgood or bad; it is only the materialthat taste then gets to act on. Last stated 2 months ago 6 Aug 2026 GS George Saunders — holds since 2026-08-06 — tap for who they are Same subject: A business is more likely to fail from taking on too much complexity than from lacking resources. — tap to centre the map on it A business is more likely to failfrom taking on too much complexitythan from lacking resources. Last stated 8 years ago 29 Sept 2018 TG Tren Griffin — holds since 2018-09-29 — tap for who they are Same subject: A business succeeds through a small number of highly effective distribution channels, not many mediocre ones. — tap to centre the map on it A business succeeds through a smallnumber of highly effectivedistribution channels, not manymediocre ones. Last stated 3 years ago 17 Feb 2024 AW Adam Wiggins — holds since 2024-02-17 — tap for who they are Same subject: A candidate negotiating an offer should make every ask fit one line of logic. — tap to centre the map on it A candidate negotiating an offershould make every ask fit one lineof logic. Last stated 2 months ago 9 Aug 2026 AW Adam Ward — holds since 2026-08-09 — tap for who they are
same subject or similar wordinga cloud: claims about one subject, named for itbar: when it was last stated, on a scale from 2015 to today — full is todaya face: someone who holds the claim — tap it for who they are

At the centre Good documentation is produced by effort, not by tooling that keeps code and docs together Last stated 18 Jan 2026 · 9 months ago Holds Hamel Husain Read this korrent →