(Opinions are my own) My favorites from the list, that I did not see other companies (specifically startups) do at all: > A single large release may be divided into a series of lower-risk well-understood rollouts. > Design documentation should not be an afterthought but an integral part of the software engineering process. > Coordinate reviews for the design doc and compare the design as it evolves with the original…
> It might suck to spend 4hr writing a doc Maybe our releases are too big but our technical specs take much longer to write and even longer to coordinate stakeholders when conflicts do come up. Can people really crank these docs out in 4 hours?
Software Engineering Insights from 10 Years at Google
11–20 of 151 posts
Re: Software Engineering Insights from 10 Years at Google
#12Re: Software Engineering Insights from 10 Years at Google
#13(Opinions are my own) My favorites from the list, that I did not see other companies (specifically startups) do at all: > A single large release may be divided into a series of lower-risk well-understood rollouts. > Design documentation should not be an afterthought but an integral part of the software engineering process. > Coordinate reviews for the design doc and compare the design as it evolves with the original…
What's critical is that this remains an informal process. The moment this process becomes codified into a formal doc that requires approvals and reviews across teams, is the moment this ends up becoming a far larger part of the work than it should. Making it a required aspect of the job dramatically slows down the work and makes the doc act as a gatekeeper to technical work.
Re: Software Engineering Insights from 10 Years at Google
#14Re: Software Engineering Insights from 10 Years at Google
#15Has someone collected all these self-aggrandizing posts that spew from ex-Googlers and current Googlers? It feels like a pre-requisite for their promotion packets. These all sound about the same and are altogether unhelpful. Note the copious links to terms and inlined quotes rather than an actual study, or any evidence at all...just vague rewording of colloquial expressions commonly traded around. The only use seems…
Even if you can’t find value in what was written just take it as a lesson in what not to do.
Re: Software Engineering Insights from 10 Years at Google
#16Archive link: https://web.archive.org/web/20220518230424/https://addyosman...
Re: Software Engineering Insights from 10 Years at Google
#17Re: Software Engineering Insights from 10 Years at Google
#18Has someone collected all these self-aggrandizing posts that spew from ex-Googlers and current Googlers? It feels like a pre-requisite for their promotion packets. These all sound about the same and are altogether unhelpful. Note the copious links to terms and inlined quotes rather than an actual study, or any evidence at all...just vague rewording of colloquial expressions commonly traded around. The only use seems…
On the other hand we have a bunch of people spending too much time on hacker news, often with all the insight of someone who spent 5 minutes scanning a wikipedia article. I'd worry a lot more about the long term effects of elevating this self congratulatory content, but where's this content cop then?
> It may seem harsh
Honestly it seems like it's trying too hard. Call it feel good vagueries and move on.
Re: Software Engineering Insights from 10 Years at Google
#19Re: Software Engineering Insights from 10 Years at Google
#20Honestly I think the better example would be from a tiny company that can't afford to do things wrong.