Related posts
Hillel Wayne
GitHub
alloydocs — Proposed documentation for alloytools.org
documentation proposed
The subject this post names, from the same vocabulary
the directory files beliefs under, and the word it uses that this site has seen
least often elsewhere. Posts are matched on those words alone —
nothing here is a summary of this one.
Sources
All Writing Blog Mastodon GitHub Korrents x.com Newsletter Recommends Papers
Top people
Julia Evans
Alice Ryhl
Daniel Stenberg
Bob Nystrom
Sabine Hossenfelder
Matt Birchler
Richard Stallman
Elio Struyf
Tyler Cowen
Brett Terpstra
Ryan Singer
Terence Tao
Showing Profile →
Show everything
Hiding Show them again
Show them again
Further back ↓
Hiding Show them again
19 September
Designer, product manager, YouTuber and developer who has written about technology at Birchtree since 2010. He makes the Quick Reviews and Quick Notes apps and the A Better Computer YouTube channel.
17 September
Founder of the Free Software Movement and the GNU Project, original author of GNU Emacs and the GNU General Public License, and long-time president of the Free Software Foundation.
https://actionnetwork.org/forms/become-a-citizen-co-sponsor-of-the-green-new-deal-for-health US citizens: support the proposed Green New Deal for Health. Related
Belgian engineering lead, Microsoft MVP and public speaker. Creator of Front Matter, a headless CMS extension for Visual Studio Code.
16 September
Economist at George Mason University, co-author of Marginal Revolution, host of Conversations with Tyler. Writes in short, dense claims about economics, culture and AI, and has moved position on AI in public more than once.
14 September
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
poll: to look up the official documentation for "git pull", would you use: (you can pick more than one) documentation Related
12 September
Mac developer and writer at brettterpstra.com; makes the apps Marked and nvALT and writes extensively about Markdown and automation.
7 September
Author of Shape Up; formerly head of strategy at Basecamp, where he worked on product design for seventeen years; now runs Felt Presence.
The 7+/-2 rule never fails. I thought I was ready to kickoff something we shaped. But putting it through my documentation process felt hard. Why? Oh yeah. Missing a level of chunking. Suddenly way easier to talk about w/ both the team and agents. documentation Related
5 September
Mathematician at UCLA, working mainly in harmonic analysis and partial differential equations. Writes What's new, a long-running blog on their research, open problems and expository notes.
A new proposed competition for AI companies: rather than being the first to announce solutions to unsolved math problems, be the first to announce a new mathematical insight. Related
2 September
Writer on the intersection of technology and finance. Author of the Bits about Money newsletter and host of the Complex Systems podcast; previously at Stripe.
Being willing to read the documentation is a superpower, and I don’t think it becomes less of one in a world where technological or social changes make it rarer. documentation Related
31 August
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
I'm working on phase 2 of Project Improve Git's documentation and I need beta readers! Here's a signup form: https://forms.gle/swn1jhCULndnCxG87 The first topic is going to the docs on merge conflicts. I'd love signups from anyone who uses Git on the command line and who would be interested in reading the current version of some man pages and leaving feedback about what's confusing. Especially if you're not 100% comfortable with Git! documentation Related
Statistician and Chief Scientist at Posit (RStudio). Author of the ggplot2, dplyr and tidyverse R packages and of books on R programming and data science.
28 August
Developer and podcaster; created Instapaper and Overcast, co-founded Tumblr, and co-hosts the Accidental Tech Podcast.
I couldn't figure out this bug, so I asked Fable, and it was SO much more incredible than I expected. - My bug report was wrong in a way I didn't notice - There technically was no bug, but a flawed design caused unintended outcomes - It verified that the design almost certainly caused me to fall into that trap, and proposed a simple, effective fix Wow. Related
21 August
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
poll: do you prefer examples with: (you can pick more than one, trying to think about what my opinions are about the use of placeholders in examples) EDIT: please no more comments about the official recommended values for ip addresses and hostnames in documentation, try to think about that as a separate question documentation Related
1 August
Structural engineer and senior infrastructure fellow at the Institute for Progress; writes Construction Physics on why physical things cost what they cost.
15 July
Writer and former Substack product manager; publishes essays and interviews on technology, culture and China at jasmi.news.
day 1 was Madison and Janesville, WI the latter town is known for the 100-year old GM factory that devastated the community when it shut down in 2008 it's been an abandoned lot for the last 15 years. now there's a data center being proposed, but some residents are skeptical Quoting @jasminewsun I’m spending the next week driving around Wisconsin and Michigan to get a firsthand view of the data center buildout and backlash am visiting sites, talking to tons of people — tradespeople, activists, planners, residents — then writing up a story lmk what questions I should dig into! data centers Related
3 June
Engineer and teacher; wrote Kubernetes the Hard Way, was a distinguished engineer at Google Cloud, and retired from full-time work in 2023.
documentation
Their words
I'm watching people write these huge markdown files to give the agent context. How about you write documentation to give me context so I can have fully working examples.
Show the whole quote
youtube.com
20 May
Rust engineer at Google working on Android; maintains Tokio and works on Rust in the Linux kernel.
From one piece
Why Rust is different, with Alice Ryhl
2 beliefs, in the piece's order there
documentation
Their words
Now the thing is you can of course write examples in your documentation and Rust makes all examples into tests. This means that if you change the underlying code now your test fails. And so this means that you can't even you can't forget to update your examples in your documentation.
Show the whole quote
Why Rust is different, with Alice Ryhl youtube.com
documentation
Their words
And what this is is that in the guide level explanation, you explain your feature as if you were writing a guide as if the feature already existed. And in the reference level explanation, you explain your feature again as if it already existed, but as if it would be in the language reference instead of a tutorial.
Show the whole quote
Why Rust is different, with Alice Ryhl youtube.com
8 May
Freelance web developer and instructor. Author of the Dive Into Docker course; writes tutorials on Docker, deployment and development environments at nickjanetakis.com.
20 April
Computer scientist and director of the MIT Digital Currency Initiative; her research covers distributed systems, databases and digital currency.
Follow up on Bitcoin and Quantum: A proposed roadmap. https://t.co/QoOrvnxeOe tl;dr: we should work towards activating a PQ-safe output type with PQ signatures now. everything else (including escape hatches, zk proofs, commit/reveal, to freeze or not) can, and should, wait. Related
23 March
Creator of Ruby on Rails, CTO of 37signals, and creator of Omarchy.
20 March
Founding member of OpenAI and former director of AI at Tesla; creator of nanoGPT and the term "vibe coding".
documentation
Their words
It used to be that you have documentation for other people who are going to use your library, but like you shouldn't do that anymore. Like you should have instead of HTML documents for humans, you have markdown documents for agents.
Show the whole quote
youtube.com
10 March
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
2 March
Clinical psychologist, EMDR consultant and yoga teacher in Boulder, Colorado. Author of The Complex PTSD Workbook and EMDR Therapy and Somatic Psychology; writes on trauma, attachment and the nervous system.
1 March
Programmer; wrote Redis and hping, and blogs about C, systems programming and working alone.
18 February
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
Notes on clarifying man pages Hello! After spending some time working on the Git man pages last year, I’ve been thinking a little more about what makes a good man page. I’ve spent a lot of time writing cheat sheets for tools (tcpdump, gi…
documentation Related
12 February
Founded PSPDFKit in 2011 and ran it for a decade. Came back from a break to work on AI agents — the OpenClaw project, and OpenAI, joined in February 2026. Writes at steipete.me.
documentation
Their words
That's why I warn in my security documentation, don't use cheap models. Don't use Haiku or a local model. Even though I, I very much love the idea that this thing could completely run local. If you use a, a very weak local model, they are very gullible. It's very easy to, to prompt inject them.
Show the whole quote
youtube.com
5 February
Engineering leader and writer; wrote An Elegant Puzzle, Staff Engineer and The Engineering Executive's Primer, and blogs at Irrational Exuberance.
18 January
Machine learning engineer and independent AI consultant. He writes about LLM evaluation, tooling and applied ML at hamel.dev, and previously worked on machine learning at GitHub.
8 January
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
4 January
Swedish open source developer; creator and lead maintainer of curl and libcurl, and a co-founder of the Rockbox project.
16 November 2025
Software engineer writing about maintenance, open source and the industrial reality of software — the author of "I am not a supplier".
16 October 2025
Swedish open source developer; creator and lead maintainer of curl and libcurl, and a co-founder of the Rockbox project.
27 September 2025
Programmer and teacher; writes on software, learning and the web, and makes the Coding Blocks video course.
Examples are the best documentation When I'm searching for docs, 95% of the time a single example would suffice. Yet, 95% of the time I can't find one in any official source. It seems that by default formal technical documentation is targeted towards some…
documentation Related
1 July 2025
Programmer on the Dart language at Google and author of Game Programming Patterns and Crafting Interpreters; previously a game developer at EA.
25 May 2025
Co-creator of Django and creator of Datasette; writes daily at simonwillison.net.
Their words
I still think Anthropic have the best prompting documentation of any LLM provider.
Show the whole quote
simonwillison.net
31 March 2025
Programmer on the Dart language at Google and author of Game Programming Patterns and Crafting Interpreters; previously a game developer at EA.
5 July 2024
Swedish open source developer; creator and lead maintainer of curl and libcurl, and a co-founder of the Rockbox project.
3 July 2024
Programmer on the Dart language at Google and author of Game Programming Patterns and Crafting Interpreters; previously a game developer at EA.
25 April 2024
Professor at Carnegie Mellon working on self-driving-car safety; writes Safe Autonomy on how autonomous vehicles are and are not shown to be safe.
25 March 2024
Independent policy analyst on space and national security, formerly of the RAND Corporation, who writes on counterspace weapons and rules for keeping satellites safe.
Their words
We accordingly proposed a framework of self-defense zones to “facilitate unilateral defense against a surprise attack on satellites.”
Show the whole quote
thespacereview.com
18 March 2024
Co-founder and CEO of OpenAI; previously president of Y Combinator.
Their words
I think the question behind that question is, do people who create valuable data deserve to have some way that they get compensated for use of it, and that I think the answer is yes. I don’t know yet what the answer is. People have proposed a lot of different things. We’ve tried some different models. But if I’m like an artist for example, A, I would like to be able to opt out of people generating art in my style. And B, if they do generate art in my style, I’d like to have some economic model associated with that.
Show the whole quote
youtube.com
18 September 2023
Theoretical physicist and philosopher, Homewood Professor of Natural Philosophy at Johns Hopkins and fractal faculty at the Santa Fe Institute. Writes the Preposterous Universe blog and hosts the Mindscape podcast.
4 July 2023
Physicist and science communicator. Writes Backreaction and makes videos explaining new physics and astronomy results, frequently to argue that the headline about them overstates the case.
1 March 2023
Deep-learning researcher and Turing Award laureate; founder of the Mila institute.
27 January 2023
Machine-learning researcher; has written the Lil'Log survey posts on how a model technique works since 2017, and worked at OpenAI from 2018 to 2024, latterly leading its safety systems team.
17 January 2023
Writes jvns.ca, turning "hard and scary" topics — networking, debugging, Linux internals — into plain explanations and hand-drawn comics. Publishes Wizard Zines, illustrated programming zines. Software developer based in Montreal.
Their words
the Go standard library documentation is probably my favourite language reference
Show the whole quote
jvns.ca
28 May 2022
Indonesian software engineer, educator and engineering manager at Zero One Group; open-source enthusiast writing at ripandis.com.
Their words
System for notes, knowledge base, and project management. Helps organize and store references, documentation, and roadmaps.
Show the whole quote
ripandis.com
19 October 2021
Philosopher and historian of existential risk; wrote Human Extinction, and coined "TESCREAL" with Timnit Gebru for the cluster of ideologies they argue underpins the AI industry.
1 May 2020
Medicinal chemist; has written In the Pipeline, the drug-discovery blog, since 2002, and the “Things I Won’t Work With” posts about chemicals that try to kill you.
8 April 2019
Software engineer who writes the blog Made of Bugs about performance, debugging and understanding computer systems. Previously worked at Anthropic on interpretability, at Stripe on Sorbet, and at Ksplice.
Their words
This is far and away the best general-audience technical documentation of the Apollo missions I've read.
Show the whole quote
blog.nelhage.com
11 September 2018
Physicist and science communicator. Writes Backreaction and makes videos explaining new physics and astronomy results, frequently to argue that the headline about them overstates the case.
27 June 2017
Rust engineer at Google working on Android; maintains Tokio and works on Rust in the Linux kernel.
27 January 2017
Web developer and musician; co-creator of the Django web framework, founder of EveryBlock and of the music-notation site Soundslice.
Nothing matches. Show everything
A korrent is a belief a person has stated in their own words: one
sentence stating the claim, backed by a quote and a source, kept at
korrents.com .
Under a name here, the quoted block is what they actually said.
The korrent beneath it is the claim those words support, in
korrents' wording — tap it to see the record, its source, and who
else holds it.
Nobody here wrote their own korrents. They are compiled from public
statements, and a person can change their mind, which is recorded too.
Got it
About the English under a post
Some people here publish in a language other than English. Where they
do, this site shows a machine translation beneath the post, in
this typeface — the site's own, not theirs.
The post itself is never changed, moved or hidden: what is set in the
serif above is exactly what the person published, and it is what to
quote them on. A translation can be wrong in ways that matter,
especially about tone.
Only the post's own words are translated. A quoted post, a linked
article and a belief on korrents.com
are left in their original language.
Got it