Related posts
Julia Evans
Mastodon
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 addresses poll
The subject this post names, from the same vocabulary
the directory files beliefs under, and the words 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 Truth Social x.com GitHub Mastodon Bluesky Korrents Newsletter Recommends Papers
Top people
Julia Evans
Alice Ryhl
Daniel Stenberg
Donald Trump
Kris Abdelmessih
Matt Birchler
Elio Struyf
Brett Terpstra
Ryan Singer
Andy Baio
Nate Silver
Patrick McKenzie
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.
President of the United States, the 45th from 2017 to 2021 and, as of 2026, the 47th; before politics a New York property developer who ran the Trump Organization, and the host of The Apprentice from 2004 to 2015.
Many people think that the words “Artificial Intelligence” are inaccurate, and very ineloquent, relative to AI, or Artificial Intelligence. A far more elegant and accurate description of this new phenomena would be Superior Intelligence (SI) or, Extreme Intelligence (EI) or, Supreme Intelligence (SI). This is a Poll, and I would appreciate everybody voting! Which is the best name for this ever growing “Revolution?” President DONALD J. TRUMP Related
17 September
Former options market maker who writes Moontower, a newsletter on trading, volatility, decision-making and how to think about risk outside markets too.
The option arbitrage stuff via yesterday's poll, @DeepDishEnjoyer dividend, and the silver early exercise post has spawned a bunch of chats on TL & DMs. Seems to be a lot of people screwing with options but missing fundamental education. Another first-principles type example: Related
Belgian engineering lead, Microsoft MVP and public speaker. Creator of Front Matter, a headless CMS extension for Visual Studio Code.
Former options market maker who writes Moontower, a newsletter on trading, volatility, decision-making and how to think about risk outside markets too.
Smart followers. Would love to see the same poll run on some other timelines. Quoting @KrisAbdelmessih Interest rates are 0, no dividends, stock is at $100. Assume 1 year to expiration. What is the maximum fair-value of the $100-strike straddle? If the straddle trades at its max value, what is the straddle’s delta? Related
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
4 September
Writer and developer; runs Waxy.org, co-organises the XOXO festival, and was the first CTO of Kickstarter.
Rogue OpenAI agents using public wikis as message boards — in a week, a swarm of 3,700 agents made 13k edits with disposable email addresses to collude on tasks OpenAI Related
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: when you copy config files (or other important files) over SSH to a server, do you: Related
3 September
Forecaster, founder of FiveThirtyEight, author of The Signal and the Noise and On the Edge. Writes Silver Bulletin, where the predictions come with numbers and the numbers are later checked against what happened.
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
Technology writer and podcaster; former Macworld editor-in-chief, writes Six Colors and hosts podcasts on Relay FM and The Incomparable.
Congratulations to alix e. harrow for winning the Hugo for best novel and also, in a slightly less distinguished award nobody should care about, the Incomparable’s annual poll for our favorite Hugo/Nebula novel nominee. theincomparable.com
Related
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.
26 August
Security researcher; founded Have I Been Pwned, and writes and speaks about data breaches.
Just blogged: It's very easy to pull email addresses from a data breach and make claims about scope that are completely wrong. Like - MASSIVELY wrong - for example: troyhunt.com
Related
25 August
Web standards author and speaker; wrote the CSS: The Definitive Guide series and co-founded the An Event Apart conference.
Pronunciation poll! Which of the following is the closest to how you pronounce “sherbet”? Related
19 August
Computer science professor who works on fast data processing; co-author of the simdjson parser and a weekly blogger about software performance since 2004.
Parsing IP addresses in C# at crazy speeds We are all familiar with IP addresses such as 192.168.0.1. They are typically written as four numbers in the range 0 to 255 inclusive, separated by dots. In C#, you can parse them with the standard library using IPAddre…
Related
18 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: when you first learned linux/unix, did you use (you can pick more than one): (not looking for extra details right now, I'm just reflecting on the role of "free internet resources" recently) Linux Related
20 July
Political scientist and Baptist pastor; writes Graphs about Religion, charting American religious life from survey data.
8 July
Journalist and author of The Art of Noticing; writes the newsletter The Art of Noticing (TAoN) on attention, creativity and the everyday.
20 June
President of the United States, the 45th from 2017 to 2021 and, as of 2026, the 47th; before politics a New York property developer who ran the Trump Organization, and the host of The Apprentice from 2004 to 2015.
POLL: ICE has been abused by the Fake News Media at levels never seen before. They are Great Patriots who work hard, and do a fantastic job in a very hostile environment. Much of this hostility is caused by the Dumocrats and the Fake News. The concept I have had for quite some time — A strong feeling that the name of these Patriots, “ICE,” should be changed to, “NICE,” in that it will totally discombobulate Crooked, Dishonest, and Unpatriotic Reporters and Journalists. For them to say, “We went to a NICE Facility today,” as opposed to “ICE” or, “NICE Agents have deported a Violent Drug Dealer… 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.
13 April
Writer and former Substack product manager; publishes essays and interviews on technology, culture and China at jasmi.news.
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.
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.
13 November 2025
Cryptographer; teaches cryptography at Johns Hopkins and writes A Few Thoughts on Cryptographic Engineering.
One of the most interesting recent privacy developments is the deployment of big two-hop IP blinding VPNs by companies like Apple and Google. These systems are designed to ensure that even those companies can’t link web requests to IP addresses. Google Related
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
9 September 2025
Writer and consultant on formal methods and software correctness; author of Practical TLA+ and Logic for Programmers.
3 September 2025
Pen name of the Canadian-American writer behind mrmoneymustache.com, a blog on frugality, early retirement and index-fund investing that has run since 2011.
Looking for some technical advice on an interesting AI-related problem. I've been running the MMM Forum website for 10 years with no problems. 45k registered users, 3M posts and 20M+ visitors over the years! But now, thousands of AI scraper bots are overrunning it around the clock. It makes sense, there is a LOT of wisdom in those posts from the users and it would make a juicy addition to any future digital brain. They don't obey the robots.txt instruction files and they randomize their IP addresses and spread out the load so they can't be blocked. This has overloaded even the relatively larg… Related
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
5 July 2024
Swedish open source developer; creator and lead maintainer of curl and libcurl, and a co-founder of the Rockbox project.
30 January 2024
Science fiction novelist, journalist and technology activist; writes the daily blog and newsletter Pluralistic, and coined the term enshittification.
1 March 2023
Deep-learning researcher and Turing Award laureate; founder of the Mila institute.
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
12 September 2022
Founded CD Baby in 1998 and sold it in 2008, giving the proceeds to a charitable trust for music education. Since then a writer and speaker: five books and 550+ articles, published first at sive.rs, which they hand-code and keep free of advertising.
Their words
How to improve your HUGE major life decisions, like whether/who to marry, whether to have kids, where to live, career paths, and such — where you can’t use the usual checklist/data approach. This economist addresses self-identity, “deepest self”, and “something I was meant to do”. You can’t use a pro/con checklist with an item that says “lose respect for myself”.
Show the whole quote
sive.rs
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
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
31 January 2019
Art critic, broadcaster and author; wrote on art for The Independent and The Sunday Telegraph and presents BBC art documentaries. Author of Caravaggio: A Life Sacred and Profane.
Their words
This is a micro-study of how one might interpret the paintings of Turner and Constable and what they're really trying to do. It's one of the very few works I've ever read about Turner or Constable that addresses the real issues of their work.
Show the whole quote
fivebooks.com
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