News for hackers. Stuff that matters.
Re:Things to say when you're losing a technical argument (2001) by endisneigh on Friday November 05, 2021 @01:55PM (#29122612)
I hope you don't work at Google with that attitude, lol.

context: design docs are frequently written at G.

Re:Things to say when you're losing a technical argument (2001) by isoskeles on Friday November 05, 2021 @02:07PM (#29122772)
Is there a difference between white paper and design doc? My impression is that a white paper is more academic, and so I'm not sure what it ends up looking like.

At one of my jobs, we wrote design docs for most major changes (we had a checklist for deciding if the doc was necessary at all). It was ultimately quite helpful because documentation about most important changes existed, even if the dev didn't write any documentation in code. The technical designs also had a template, so it was a fairly easy path for a developer to know what questions to answer or not in their doc.

Is this the same idea as a white paper?

Re:Things to say when you're losing a technical argument (2001) by pie42000 on Friday November 05, 2021 @03:15PM (#29123600)
White paper sounds cooler
Re:Things to say when you're losing a technical argument (2001) by sitkack on Friday November 05, 2021 @02:33PM (#29123102)
I have seen google design docs at google, most are trash. Most design docs everywhere are trash. The confuse more than they explain. I don't care if the idea is good, if the design doc stinks, it will kill a good idea.
Re:Things to say when you're losing a technical argument (2001) by Ancapistani on Friday November 05, 2021 @03:15PM (#29123609)
Effectively communicating a complex idea is a skill that's orthogonal to coming up with good ideas.

I advise other engineers, especially those early in their careers, to actively develop and hone their communication skills. It deserves far more focus than most people seem to give it.

Re:Things to say when you're losing a technical argument (2001) by xpe on Friday November 05, 2021 @10:47PM (#29127072)
What are some of the key problems you've seen?
Re:Things to say when you're losing a technical argument (2001) by sitkack on Saturday November 13, 2021 @11:39AM (#29211039)
You can't _build_ anything from them. They talk around things, kinda layout the problem, talk nebulously about a way to solve it and then ... nothing.

The appear to be an artifact of a policy, the problem they solve is 'not having a design document' and nothing more.

Re:Things to say when you're losing a technical argument (2001) by ZainRiz on Friday November 05, 2021 @04:32PM (#29124421)
At google, the templates for my 1 pager used to be two pages long
Re:Things to say when you're losing a technical argument (2001) by z3ncyberpunk on Monday November 08, 2021 @05:47PM (#29155298)
Why would you want to work at Google in the first place? Gross