HN Hall of Fame Weekly email

Design Docs at Google

www.industrialempathy.com Books & learning Tutorials & guides Software engineering Class of 2024-05 Hall of Fame
Screenshot of www.industrialempathy.com captured 2026-07-20
Page preview · captured 2026-07-20

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

submissions
6
submitters
5
observed span
2020–2024
peak thread · 187 comments
459 pts
latest 20+ return · 2024-05-06
345 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

Design docs are one of my favourite things about software engineering. If code is the bricks and mortar, then these docs are the blueprints. I know this is fairly controversial, but our jobs isn't just to write code. Navigating organisations and achieving consensus between a lot of teams/technologies is a huge part of it. Design docs are a way to get all of that out of the way _before_ writing thousands of lines of code. The review process nets significantly…

Design doc culture at google is why I left the company. I wrote a very high level doc shortly after joining the company outlining a fairly trivial task (one that has been performed many times across other product areas). A colleague virtually took me aside and told me "this is not how we do things here". Which was kind of a wake up call as he told me to make sure to 'evaluate many more ways to get this done'…

SSchick·345-point thread·

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
2

100+ points or 50+ comments

Total points
812

reference only — not used in Hall rules or ranking

Total comments
372

reference only — not used in Hall rules or ranking

Every submission

DateTitle as submittedByPointsComments
2020-07-06Design Docs at Googlecramforce20
2020-07-10Design Docs at Googlecramforce30
2020-07-22Design Docs at GoogleFirst breakout · Best threadthesephist459187
2023-09-16Design Docs at Googlettanay66610
2024-05-05Design Docs at Googlekiyanwang20
2024-05-06Design docs at Google (2020)Hall induction · Latest 20+ point returnBerislavLopac345185