News for hackers. Stuff that matters.
Re:Design Docs at Google by underdeserver on Wednesday July 22, 2020 @11:49AM (#23918267)
"The design is the code" does not follow from the idea that design and construction are not separate things in software.

The thing to take away from that idea is that the design doc is not law written in stone, but a base for changes. It keeps your design honest on the high level. If you end up clashing with reality, and your design doesn't work out, you can backtrack to the design doc and refine it as necessary.

In short, the design doc should be a living document.

Re:Design Docs at Google by nickbauman on Wednesday July 22, 2020 @12:15PM (#23918585)
I think what you're talking about here is an "intention document" not a design document. Design is about planning. Which implies you define things in detail with steps and techniques. Intentions are about what you want to achieve. Very different.
Re:Design Docs at Google by underdeserver on Thursday July 23, 2020 @12:01PM (#23928759)
The design doc is definitely the plan. But if the plan doesn't work when faced with reality, you need to change the plan, and therefore also the design doc.
Re:Design Docs at Google by maps7 on Wednesday July 22, 2020 @06:33PM (#23922310)
A design is an outline, sketch, or plan. So it doesn't specify the level of detail.