HN Hall of Fame Weekly email

Readme Driven Development

tom.preston-werner.com Essays & writing Essays & articles Software engineering Candidate
Screenshot of tom.preston-werner.com captured 2026-07-20
Page preview · captured 2026-07-20

Resurfaced independently across 7 calendar years, with breakout response in 3 of them.

submissions
9
submitters
7
observed span
2010–2023
peak thread · 57 comments
242 pts
latest 20+ return · 2020-11-26
226 pts

Submission timeline

2007–2026

One slot for every year since HN launched. Height is that year's peak points; orange marks a 100+ point or 50+ comment breakout. Select a bar to open its strongest thread.

First comments on top threads

HN comment order

Seems that mojombo practices what he preaches. First commit by mojombo (from march 29, 2010) of Github's Gollum wiki reads "readme driven development!" http://github.com/github/gollum/commit/c7875704971be998a5399...

Author here. Fun to see this come up on HN again, every so often. Readme Driven Development still serves me well (that’s how we drove RedwoodJS early on) and we even expanded that into Tutorial Driven Development, where we wrote the RedwoodJS tutorial to show what we wanted to be possible from a DX perspective, and then figured out what code we needed to write to make it possible. It’s been an efficient way to focus on what’s important and…

mojombo·226-point thread·

One of the senior engineers I worked with at my last job was very picky about the difference between verification and validation activities. In testing, most design engineers will focus very heavily on verification activities which seek to answer the question "does what I built satisfy my design intent?" In contrast, validation activities seek to answer the question "did I design and build a thing that actually solves the problem?" It's very important when you're building something that you answer…

This article looks like it has some good ideas in it. But the practical side of me thinks it would probably only work well in the context of small- to medium-sized projects whose users include few, if any, technically ignorant people (libraries, command-line tools, etc.). Maybe (?). Also, this has been submitted & discussed before: http://news.ycombinator.com/item?id=1627246

The first top-level comment from each of the four biggest threads, in HN’s own order. Excerpts are shortened; open a comment for full context.

Breakout years
3

100+ points or 50+ comments

Total points
766

reference only — not used in Hall rules or ranking

Total comments
159

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2010-08-23Readme Driven DevelopmentFirst breakout · Best threadmojombo24257
2011-04-29Readme Driven Developmentshawndumas699
2017-11-02Readme Driven Developmenttimhigins20
2018-02-23Readme Driven Development (2010)alouanchi20
2018-06-29Readme-Driven Development (2010)js221750
2020-11-25Readme Driven Developmentpcr91030320
2020-11-26Readme Driven Development (2010)Latest 20+ point returnpcr91030322642
2022-07-09Readme Driven Developmentpcr91030340
2023-05-22Readme Driven Developmentbrentroose21