编程与软件工程tom.preston-werner.com编辑精选
README 驱动开发
Readme Driven Development
2010 — 2020，它一次次回到首页
黑点是上首页（≥ 50 分）的那次投稿，空心点是没冲上去的投稿，点越大分数越高。
导读
Tom Preston-Werner（GitHub 联合创始人）在 2010 年提出的“README 驱动开发”：在写代码之前先写 README，用它来明确项目的用途、API 和使用方式，从而以低成本进行设计迭代。作者本人后来在 RedwoodJS 中还将其扩展为“教程驱动开发”。
为什么经久不衰：它把“设计先行”简化为写一个 README 这件人人可做的小事，十年来反复登上 HN 首页，至今仍是启动新项目的实用方法论。
HN 评论精选
作者本人确实践行了自己倡导的方法
看来 mojombo 言行一致。他 2010 年 3 月 29 日对 GitHub 的 Gollum wiki 的首次提交信息就是“readme driven development!”
clemesha查看英文原文
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/c7875704971be998a5399ce83e66a5dada03aad4
作者十年后确认方法依然有效，并扩展为教程驱动开发
作者来了：很高兴这篇文章还常被翻出来。RDD 至今对我很有用（RedwoodJS 早期就是这么驱动的），我们还扩展成了“教程驱动开发”——先写教程展示我们希望达到的开发者体验，再倒推需要写什么代码。这本质上是设计优先的方法 applied 到框架上。
mojombo查看英文原文
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 not make usability sacrifices for the sake of easy coding. It’s really just the design-first approach, applied to a framework!
RDD 本质是常识，警惕方法论变成机械清单
绕了一圈，这不就是“设计驱动的设计”吗？早期写 README 当然是好主意，但说到底他只是在说：任何软件工程方法论都替代不了常识。当人们把常识形式化（并包装成品牌去营销）时，往往是用清单代替了思考。
silentbicycle查看英文原文
So in a roundabout way, we're back to...design-driven design? Writing a README early on (and figuring out your general project scope, etc.) is a good idea, sure. Fundamentally, though, it sounds like he's just saying that a Software Engineering Methodology(TM) is no replacement for common sense. When people attempt to formalize (and, often, brand & market) common sense, it tends to substitute checklists for thought.
先写使用示例再实现，能让库的 API 设计更好
我写库就是这么做的，只是从没把它正式化：先写带使用示例和说明的 README，再照着设计库。很多库（尤其 .NET 的）就是缺了这种先设计的味道。
natchy查看英文原文
This is how I write libraries but never formalized the tactic. Basically create a readme with example of how to use the lib with explanation. Then I design the library to match my design. I see lots of libraries (especially in .net) that are missing that extra something as if they weren’t designed first.
Doom 先发新闻稿再开发，是同样的思路
这让我想起 Doom 的开发：他们在写游戏之前先发了新闻稿。每次开始新项目前我都会想起这个轶事。
joakleaf查看英文原文
This reminds me of Doom’s development, where they did the press release before writing the game: https://rome.ro/news/2018/12/10/reflections-on-dooms-development I always think of that anecdote before starting a new project.
历次讨论
同类还值得读
开源应用架构
The Architecture of Open Source Applications
《开源软件架构》（AOSA）是一本在线免费书，邀请知名开源项目的作者亲自剖析其内部设计，涵盖 SQLAlchemy、LLVM、Audacity、Apache、Bash 等系统。
编程与软件工程上首页 9 次 · 2011–2024aosabook.org编辑精选编程语言简史：简短、不完整且多半错误
A Brief, Incomplete, and Mostly Wrong History of Programming Languages
一篇以戏谑、故意不准确的方式回顾编程语言史的博客文章，用夸张轶事和讽刺定义串起 Lisp、C、C++、Java、JavaScript、PHP 等语言。
编程与软件工程上首页 8 次 · 2009–2021james-iry.blogspot.comSQLite 是如何测试的
How SQLite is tested
SQLite 官方文档页，系统介绍 SQLite 的测试体系：多种测试方法（TCL 测试、模糊测试、回归测试、静态分析等）和海量测试用例，展示了这个小型开源项目如何靠极致测试获得…
编程与软件工程上首页 8 次 · 2009–2025sqlite.org编辑精选高级编程语言（2009）
Advanced programming languages (2009)
Matt Might 的经典文章，按用途推荐“高级编程语言”：如果追求就业就选主流语言，如果追求表达力、学术研究或创业，则推荐 Haskell、OCaml、Scala 等函数式语…
编程与软件工程上首页 8 次 · 2009–2022matt.might.net我的 Forth 与栈机器经历
Yosefk - My history with Forth & stack machines
作者以亲身经历回顾了使用 Forth 语言和栈式机器的历程：既赞叹其简洁优雅、代码量小、可自举的优点，也坦率指出栈操作在实际编程中的痛苦，以及 Forth 社区文化中的问题。
编程与软件工程上首页 8 次 · 2010–2024yosefk.com编辑精选