Tap a claim on the ring to put it at the centre.
← A design proposal should describe the feature as though it already…
8 connected korrents · 8 moments on record from 1 May 2020 to 3 Jun 2026.
−
+
Fit
Full text
Drag to move · pinch or scroll to zoom
Everything filed under documentation
documentation Same subject Same subject Same subject Same subject Same subject Same subject Same subject Same 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 the feature as though it already existed — once as a tutorial and once as reference documentation. Last stated 4 months ago 20 May 2026 · 4 months ago
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 · 7 months ago
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 · 4 months ago
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 · 8 months ago
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 · 3 months ago
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 · 6 years ago
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… Last stated 6 months ago 20 Mar 2026 · 6 months ago
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… Last stated 8 months ago 8 Jan 2026 · 8 months ago
JE
Julia Evans — holds since 2026-01-08 — 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 · a year ago
JZ
Julie Zhuo — holds since 2025-05-12 — tap for who they are