korrents

On the map

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

← A design proposal should describe the feature as though it already…

17 connected korrents · 17 moments from 1 Mar 1999 to 13 Oct 2026. Nearly all of them are about documentation.

Everything filed under design design Everything filed under AI agents AI agents Everything filed under coding agents coding agents Same subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subjectSame subject Read this korrent: A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation. A design proposal should describe thefeature as though it already existed —once as a tutorial and once as referencedocumentation. 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: 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 byeffort, not by tooling that keepscode 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 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: 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-onglasses seems far more enticing thana $3,699, 700-gram headset strappedto 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-drivendesign is to sketch out 10 to 20hero flows and run the feature orinteraction through them to seewhere 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: itviolates the first rule of a gooduser experience, that it is obviouswhat 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 works better as a single window than as multiple separate windows. — tap to centre the map on it A browser works better as a singlewindow than as multiple separatewindows. Last stated a month ago 15 Sept 2026 CC Chris Coyier — holds since 2026-09-15 — tap for who they are Same subject: A design has to be kept simple for reliability and intellectual control, but nobody yet knows how to reach simplicity systematically. — tap to centre the map on it A design has to be kept simple forreliability and intellectualcontrol, but nobody yet knows how toreach simplicity systematically. Last stated 28 years ago 1 Mar 1999 ED Edsger W. Dijkstra — holds since 1999-03-01 — tap for who they are Same subject: A designer's edge now is pulling things back, making them simpler and more understandable, because everyone can kind of execute right now. — tap to centre the map on it A designer's edge now is pullingthings back, making them simpler andmore understandable, becauseeveryone can kind of execute rightnow. Last stated 3 months ago 29 Jul 2026 CD Charlie Deets — holds since 2026-07-29 — tap for who they are Same subject: A product's craft probably comes down to whether it works without pain and how it makes people feel. — tap to centre the map on it A product's craft probably comesdown to whether it works withoutpain and how it makes people feel. Last stated a month ago 10 Sept 2026 RS Robby Stein — holds since 2026-09-10 — tap for who they are Same subject: A shadow in an interface implies a light source, so an elevated element needs a highlight where the light falls, not just a drop shadow. — tap to centre the map on it A shadow in an interface implies alight source, so an elevated elementneeds a highlight where the lightfalls, not just a drop shadow. Last stated 2 years ago 21 Feb 2025 TC Thiago Costa — holds since 2025-02-21 — tap for who they are Same subject: A twist works best when it is discoverable on rewatch rather than achieved by directly misleading the audience. — tap to centre the map on it A twist works best when it isdiscoverable on rewatch rather thanachieved by directly misleading theaudience. Last stated 11 months ago 18 Nov 2025 NE Nat Eliason — holds since 2025-11-18 — 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 1999 to today (stretched back to the oldest claim here) — full is todaya face: someone who holds the claim — tap it for who they are

At the centre A design proposal should describe the feature as though it already existed — once as a tutorial and once as reference documentation. Last stated 20 May 2026 · 5 months ago Holds Alice Ryhl Read this korrent →