3 ms·
I hope you don't work at Google with that attitude, lol. context: design docs are frequently written at G.
by endisneigh 5y ago
I hope you don't work at Google with that attitude, lol.
context: design docs are frequently written at G.
- z3ncyberpunk 5y agoWhy would you want to work at Google in the first place? Gross
- isoskeles 5y agoIs 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?
- pie42000 5y agoWhite paper sounds cooler
- sitkack 5y agoI 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.
- Ancapistani 5y agoEffectively 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.
- xpe 5y agoWhat are some of the key problems you've seen?
- sitkack 5y agoYou 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.
- ZainRiz 5y agoAt google, the templates for my 1 pager used to be two pages long