News for hackers. Stuff that matters.
Re:Design Docs at Google by pjmorris on Tuesday May 07, 2024 @08:54AM (#40284878)
> However, it's not an up-front design doc, it has clearly been written after the bulk of the work has been done, to explain and justify rolling out a big change.

Shades of Parnas! [0]

[0] 'A Rational Design Process: How and Why to Fake It', Parnas, Clements, https://users.ece.utexas.edu/~perry/education/SE-Intro/fakei...

Re:Design Docs at Google by iainmerrick on Tuesday May 07, 2024 @08:38PM (#40293166)
Huh, I don’t recall reading this paper before, but it’s terrific! I hadn’t previously seen it laid out as clearly as this, but yes, “faking” the design doc is exactly what happens in practice, and it’s a good thing! Since we want design docs that are useful now, not just obsolete historical artifacts.