Skip to content

搞英语 → 看世界

翻译英文优质信息和名人推特

Menu
  • 首页
  • 独立博客
  • 专业媒体
  • 名人推特
  • 邮件列表
  • 关于本站
  • Product Hunt
  • Visual Capitalist
  • Elon Musk
Menu

更喜欢一次性代码而不是设计文档

Posted on 2024-12-16

更喜欢一次性代码而不是设计文档

Doug Turnbull 主张软件开发过程比尝试预先创建设计文档然后相应实施要现实得多。

正如道格所说,“没有任何计划能够在与敌人接触后幸存下来”。他的流程是在 GitHub 上的拉取请求草稿中构建原型,并在此过程中做出详细的注释,并完全打算在构建最终功能之前将其丢弃。

这种方法的重要一点是高度成熟。您可以放弃已经编码的想法还是会投资于您的第一个解决方案?资历的一个主要信号是你是否愿意用 2-3 种不同的方式编写代码。您的价值交付不是关于发送到产品的代码行,而是获得的组织知识。

多年来我一直使用问题而不是 PR 来运行类似的流程。我在 2022 年的《如何构建功能》中写过相关内容。

我喜欢记录正在进行的设计决策的问题评论(或 PR 评论)的一点是,因为它们包含时间戳,所以没有隐含的期望让它们在软件更改时保持最新状态。道格也看到了同样的好处:

另一个重要的一点是使用 PR 来记录文档。它们是开发人员最好的文档形式之一。它们是可发现的——当您试图理解为什么代码以某种方式实现时,它们是您首先查看的地方之一。 PR 并不声称反映了世界的当前状态,而是反映了某个时间点的状态。

通过黑客新闻

标签:软件工程, github

原文: https://simonwillison.net/2024/Dec/15/preferring-throwaway-code-over-design-docs/#atom-everything

本站文章系自动翻译,站长会周期检查,如果有不当内容,请点此留言,非常感谢。
  • Abdisalan Mohamud
  • Addy Osmani
  • Aeon
  • Ahoy There! on THT's den
  • Alec Muffett
  • Andreas
  • anhvn
  • Ankaph
  • Annie
  • Armin Ronacher
  • Ask Hacker News Weekly
  • Astro Blog
  • Austin White
  • Backlinko
  • Better Dev Link
  • Building Pika Out Loud
  • Caleb Hearth
  • Cédric Aellen
  • Chip Huyen
  • Colossal
  • Cooltools by KK
  • CoRecursive
  • Craig Mod
  • Curt Merrill
  • Dan Abramov's Overreacted Blog RSS Feed
  • Daniel Lemire
  • Daniel Stenberg
  • Daring Fireball
  • David H
  • David Heinemeier Hansson
  • Dayu | 大宇
  • Ed Zitron
  • Ersei
  • Ersei 'n Stuff
  • Evan Martin
  • First Page Sage
  • Founder Weekly
  • FuzzyGrim
  • Gabriel
  • Good Enough
  • Gregory Hammond
  • Habib
  • How They Make Money
  • I Love Charts
  • Ian Betteridge
  • Ivaylo Durmonski
  • Jason Kottke
  • Jason Kratz
  • Jeff Perry
  • John D. Cook
  • Jonas Hietala
  • Jonathan Snook
  • jwb
  • Kevin Kelly
  • Kevin Yank
  • Kirsty
  • Kush
  • Loris Cro
  • Maarten van Gompel
  • Manas J. Saloi
  • Mandy Brown
  • Matt Fantinel
  • Matt Mullenweg
  • Mere Civilian
  • Ness Labs
  • News Letter
  • Nicholas Carlini
  • Nicolas F. R. A. Prado
  • Niko
  • Nir Eyal
  • Noah Smith
  • Pedro Lopes
  • Positive News
  • Predrag Gruevski
  • Rachel Kroll
  • Recomendo by KK
  • rendezvous with cassidoo
  • Rest of World
  • Ruben Schade
  • Scott Galloway
  • Sébastien Etter
  • SEMrush Blog
  • Seth Godin
  • Shariq Raza Qadri
  • Simon Willison
  • Six Colors
  • Slashdot
  • Spectre Collie
  • Spyglass
  • storytelling with data
  • Streamline Blog
  • Tableau Blog
  • tekphloyd
  • The Alchemy of Money
  • The Independent Variable
  • The Marginalian
  • thriftmac
  • Tim Bray
  • Tim Ferriss
  • Tim Kellogg
  • TLDR
  • Topslakr
  • Track Awesome list
  • Trump
  • Victor Kropp
  • Vincent Ritter
  • Vox
  • Westenberg
  • Xe Iaso
  • xkcd
  • Yuri Cunha
  • Zarar
  • 未分类
  • 英文媒体
  • 英文推特
  • 英文独立博客
  • 读写错误
©2026 搞英语 → 看世界 | Design: Newspaperly WordPress Theme