Software Engineering at Google: Lessons Learned from Programming Over Time

by: Titus Winters (0)

Today, software engineers need to know not only how to program effectively but also how to develop proper engineering practices to make their codebase sustainable and healthy. This book emphasizes this difference between programming and software engineering.

How can software engineers manage a living codebase that evolves and responds to changing requirements and demands over the length of its life? Based on their experience at Google, software engineers Titus Winters and Hyrum Wright, along with technical writer Tom Manshreck, present a candid and insightful look at how some of the world’s leading practitioners construct and maintain software. This book covers Google’s unique engineering culture, processes, and tools and how these aspects contribute to the effectiveness of an engineering organization.

You’ll explore three fundamental principles that software organizations should keep in mind when designing, architecting, writing, and maintaining code:

  • How time affects the sustainability of software and how to make your code resilient over time
  • How scale affects the viability of software practices within an engineering organization
  • What trade-offs a typical engineer needs to make when evaluating design and development decisions.

The Quotes

With a sufficient number of users of an API, it does not matter what you promise in the contract: all observable behaviors of your system will be depended on by somebody.

Traditional managers worry about how to get things done, whereas great managers worry about what things get done (and trust their team to figure out how to do it).

Jevons Paradox: consumption of a resource may increase as a response to greater efficiency in its use.

The Reviews

Google has open sourced "how" they do everything. This book is about “how Google runs code”. Systems engineers should pair this book with “Site Reliability Engineering” (from Google) on “how Google runs infra”. Senior org leaders should minimally read the first part (Culture) pairing with “Work Rules” (Laszlo bock on “how Google leads”). Security Engineers should buy the very recent “Building Secure and Reliable Systems” on “how Google implements defense”. Executives should read “How Google Works” by Eric Schmidt on - “how Google works ”!First, It is admirable how the company wants to spread its hard-earned wisdom. Thank you! Many places do many things exceptionally well - but the earnestness to coach and educate others is an extreme rarity - a version of Survivorship Bias - among the “Big Techs”. Collectively, these five books, “Top N” Google Tech Talks (check YouTube) and - depending on your role - coding best practices (check their site) are collectively a combination of top notch combined technical and business education in itself.Very rarely I give a 5-star rating to a technical book, but SEaG is completely worth the two weeks I immersed myself into learning Culture, Processes and Tools of Google Software Teams. The writers are deeply knowledgable, passionate about their crafts and offer insight after insight into topics ranging from human psychology to the flaws of over-embracing mock testing.Not targeting on algorithm, language, tools or libraries, it focuses on “Software Engineering” as a system, i.e., stuff that is not taught at any school. The book disambiguates “programming” from “engineering”, and walks through the hardest engineering challenge - how to scale.It also offers a treasure of insights and ideas from how Google made a billion lines of code change at one time, or how its automated tests could successfully process 50,000 change requests a day, or how Google Production System is perhaps one of the best machines humans ever engineered. Even if you are working nowhere near Google scale, the book covers a lot of fundamentals, especially on how to sustainably develop software and make objective trade-offs while doing so. I would very highly recommend SEaG to any engineering leader trying to improve her team's game. For developers, the four extensive chapters on testing should alone be worth the entry price.Notes from the "Culture" - first of three - part of the book (most of these should be organization agnostic) ----------------------------------------------------------------------------------------------------------------------------Software Engineering is “Programming integrated over time”. From a reverse lens, code thus becomes a derivative of Software Engineering.A project is sustainable if for the expected life span of the software, you are capable of reactive to valuable changes for either business or technical reasons.The higher the stakes, the more imperfect the trade-off value metrics.Your job as a leader is to aim for sustainability and managing scaling costs for the org, the product and the development workflow.Hyperbolic Discounting - when we start coding, our implicit life-span assignment to the code is often in hours or days. As the late 90s joke went - WORA - Write Once, Run Away!Hyrum’s Law: With a sufficient number of users of an API, all observable behavior of your system will depend on a random person doing a random thing. Conceptually similar to entropy - your system will inevitably progress to a high degree of disorder, chaos and instability. I.e., all abstractions are leaky.Two spectrums of code - one way is hacky and clever, another is clean and maintainable. The most important decision is to ensure which way the codebase leans. It is programming if ‘clever’ is a complement, and software engineering if ‘clever’ is an accusation!Google's SRE book talks about the complexity of managing one of the most complex machines created by humankind - Google Production system. This book focuses on the organization scale and processes to keep that machine running over time.Scaling an org means sublinear scaling with regard to human interactions.The BeyoncĂ© rule: “If you liked it, you should have put a CI test on it”. i.e., if an untested change caused an incident, it is not the change’s fault.An average Software Engineer produces a constant number of lines of code per unit time.Treat whiteboard markers as precious goods. Well functioning teams use them a lot!60-70% developers build locally. But Google built its own distributed build system. Ultimately, even the distributed build gets bloated - Jevon’s Paradox -- consumption of a resource increase as a response to greater efficiency in its use.Humans are mostly a collection of intermittent bugs.Nobody likes to be criticized, especially for things that aren’t finished.DevOps in one sentence: Get feedback as early as possible, run tests as early as possible, think about security & production environments as early as possible - also known as “left shifting”.Many eyes make all bugs shallow. Make reviews mandatory.Three Pillars of Social Interaction - Humility, Respect, Trust.Relationships always outlast projects.You have two paths to choose from - one, learn, adapt and use the system; two, fight it steadily, as a small undeclared war, for the whole of your life.Good Postmortem output - Summary, Timeline, Proximate Cause, Impact, Containment (Y/N), Resolved (Y/N) and Lessons Learned.Psychological safety is the biggest thing in leading teams - take risks and learn to fail occasionally.Software engineering is multi person development of multi-version programs,Understand Context before Changing things - Chesterton’s Fence is a good mental model.Google tends toward email-based workflows by default.Being an expert and being kind are not mutually exclusive. No brilliant jerks!Testing on the toilet (tips) and Learning on the Loo (productivity) are single-page newsletters inside toilet stalls.1-2% of Google engineers are readability (Code Review tool) reviewers. They have demonstrated capability to consistently write clear, idiomatic and maintainable code for a given language. Code is read far more than it is written. Readability (review tool at Google) is high cost - trade-off of increased short-term review latency and upfront costs for long-term payoffs of higher-quality code.Knowledge is the most important, though intangible, capital for software engineering org.At a systemic level, encourage and reward those who take time to teach and broaden their expertise beyond (a) themselves, (b) team, and (c) organizations.On diversity - Bias is the default; Don’t build for everyone. Build with everyone; Don’t assume equity; measure equity throughout your systems.A good reason to become tech lead or manager is to scale yourself.First rule of management? “Above all, resist the urge to manage.” Cure for “management disease” is a liberal application of “servant leadership”, assume you’re the butler.Traditional managers worry about how to get things done, whereas great managers worry about what things get done (and trust their team to figure out how to do it).Being manager - “sometimes you get to be the tooth fairy, other times you have to be the dentist”.Managers, don’t try to be everyone’s friend.Hiring: A hires A, while B hires C players.Engineers develop an excellent sense of skepticism and cynicism but this is often a liability when leading a team. You would do well to be less vocally skeptical while “still letting your team know you’re aware of the intricacies and obstacles involved in your work”.As a leader - Track Happiness - best leaders are amateur psychologists; Let your team know when they’re doing well; It’s easy to say “yes” to something that’s easy to undo; Focus on intrinsic motivation through autonomy, mastery and purpose; Delegation is really difficult to learn as it goes against all our instincts for efficiency and improvement.Three “always” of leadership - Always be Deciding, Always be Leaving, Always be Scaling.“Code Yellow” is Google’s term for “emergency hackathon to fix a critical problem”.Good Management = 95% observation and listening + 5% making critical adjustments in just the right place.To scale, aim to be in “uncomfortably exciting” space.All your means of communication - email, chat, meetings - could be a Denial-of-Service attack against your time and attention. You are the “finally” clause in a long list of code blocks!In pure reactive mode, you spend every moment of your life on urgent things, but almost none of it is important. Mapping a path through the forest is incredibly important but rarely ever urgent.Your brain operates in natural 90-minute cycles. Take breaks!Give yourself permission to take a mental health day.Everyone has a goal to be “data driven”, but we often fall to the trap of “anecdata”.Google uses GSM (Goals/Signals/Metrics) framework to select metrics to measure engineering productivity.QUANTS - 5 components of productivityQuality of code; Attention from engineers; Intellectual Complexity; Tempo (how quickly can engineers accomplish something) and velocity (how fast they can push their release out); SatisfactionQuantitative metrics are useful because they give you power and scale. However, they don’t provide any context or narrative. When quantitative and qualitative metrics disagree, it is because the former do not capture the expected result!Let go of the idea of measuring individuals and embrace measuring the aggregate. Before measuring productivity, ask whether the result is actionable. If not, it is not worth measuring.

Software Engineering at Google starts with the premise that "software engineering is programming integrated over time," but it is not a programming book. It leaves the syntax and semantics of programming to other books and focuses on the culture, process, and tools that Google uses to support its software engineering activities.Despite being written by over a dozen different contributors, who work at Google, the book itself is carefully edited to share a consistent message. Perhaps this is a reflection of the software engineering processes used at Google to enforce consistency within Google's codebase.The first section on culture covers topics ranging from how to work on teams, share information, lead teams, and measure productivity. It provides a useful perspective on how Google's culture has adapted over the past two decades as the company grew from being a startup with a handful of people to having over a hundred thousand employees. These topics don't typically show up in a software engineering curriculum, but they are very valuable to understand, particularly for engineers and managers at large companies.The second section covers processes that Google has developed over time to improve productivity of a large number of people working together on a large and long-lived codebase. The topics include style guides, code review, documentation, testing, and deprecation. Two of the main lessons are the value that Google gets from consistency in its code (recognizing that code is typically read more than times than it is written), and the importance of effective automated testing that allows engineers to modify code that they did not write while remaining confident that the code still works correctly. Google has been at the forefront of promoting developer written tests (rather than relying on separate QA or validation teams), and many of the tips and techniques described for writing and maintaining effective tests are quite insightful.The final section describes the tools that Google uses to support its software engineering activities. The categories of tools are ones that are useful for any software engineering organization, but the specific details in this chapter are harder to generalize than other topics in the book. Google maintains a single source repository (the monorepo) where all its code is stored and it has built custom tools for version control, code search, build processes, code review, static analysis, dependency management, continuous integration, and compute as a service. Reading the specific details of how and why Google developed these tools is insightful, but many of the tools are tightly integrated in Google's environment and the techniques described in the chapter may not be generally applicable to other organizations.One thing I felt was missing from the book was a discussion of how Google manages its processes to work with open sources projects and share code with people outside of Google. The book focused on code that is developed internally at Google rather than projects that are developed in collaboration with an open source community (i.e Linux, LLVM). But open source is becoming an increasingly important part of software engineering and Google engineers use and contribute to many open source projects. It would be interesting to know how they collaborate with outsiders who lack access to Google's monorepo and associated development tools.Despite being over 500 pages long, Software Engineering at Google is relatively quick reading and most of the chapters are self-contained and could be read in any order. The authors presented information about software engineering that is not typically covered in university courses, and the book is recommended reading for any software engineer.

I hoped to gain more in-depth technical knowledge about the topics mentioned in this book to become a better software engineer. Unfortunately, a lot of topics covered in this book were explained in a generic way that wasn't quite beneficial (and the case studies were short). This book could potentially help organizations lead at scale, but it is more beneficial for leaders who are making large decisions at growing companies, not neccessarily for programmers.I was initially excited to read this book to learn more about software engineering to apply to my work, but I didn't get too many useful takeaways that I didn't already know (or that isn't already widely known for software engineers already). The authors are quite accomplished, making this book appealing to buy at first, but that appeal wore off quickly.

A really great book. Good background, insightful and a great way for you to get started in software engineer. Not the deepest book, but covers all that you need to know and explains things well.Buckle up and spread out your reading cause this takes a while to soak it all im and process it while getting through its many pages. Worth a buy and feel more prepared and informed then before this purchase! Great book!

I was able to co relate lots of points discussed in this book. Very good book.

Great book, but it would have been nice to see all the URL references aggregated at the end of each chapter. See, when I read the book, I don't want to interrupt my reading flow just to distract myself and open the referenced URL, I want to do that later, once I finish reading the chapter. But because they are not duplicated at the end of the chapter, I end up just skipping them completely.

I can especially recommend chapters about Unit Testing. They are great regardless of the programming language that you use.It would be 5 stars, but not all chapters are of the same quality. I also get a feeling that they had different readers in mind, or just were written more as a promotional material.Overall I can recommend it.

Very nice case as described. Perfect for Worx tool. Thank you.

Pros: I like the color match between my cutter and the case. The zipper is easy to open and close. I really like the hard, sturdy exterior shell. I like that it has a separate interior zippered compartment for my charger, user manual, and warranty info. I like that it has a carry handle.Con: The only con I have, (which is why I knocked off 1 star from the overall rating) is that the elastic band that holds the cutter in place isn’t adjustable. It would have been a better design to have an adjustable Velcro wrap. Every time I go to open the case, my cutter has been moved around because it hasn’t been held in place by the elastic band. So I will probably take up some of the slack and pin it up so that it creates a tight fit and hold.

I used it to cut a pool liner that i had doubled up to get a more accurate cut. It cut through it so easily I had to laugh.

I am using it for small tools.Seems sturdy enough.Zipper seems OK.Zipper pocket works well.

Sturdy, good quality. Helps with rechargeable tool and chargers piles. Fits ok. I bought extra blades here also and store them inside.

Excellent product. Easy to use safe

I have no real idiom because this was ordered in error. Guess I didn’t double check before checking out

Love that I have a place to store it!!!!

Very practical, useful guides for software organizations. Not every methods work in every organizations, but the purpose of the methods clearly shows the common needs if we intend to build good software. Good, concise but also with detailed explanation and background information. Very approachable.

It is not bad, but unnecessarily very long, if you have tons of free time on your hands and are just curious about software company practices then it is for you. Any FAANG company has similar practices, you don't have to read this book to know them.

Google has open sourced "how" they do everything. This book is about “how Google runs code”. Systems engineers should pair this book with “Site Reliability Engineering” (from Google) on “how Google runs infra”. Senior org leaders should minimally read the first part (Culture) pairing with “Work Rules” (Laszlo bock on “how Google leads”). Security Engineers should buy the very recent “Building Secure and Reliable Systems” on “how Google implements defense”. Executives should read “How Google Works” by Eric Schmidt on - “how Google works ”!First, It is admirable how the company wants to spread its hard-earned wisdom. Thank you! Many places do many things exceptionally well - but the earnestness to coach and educate others is an extreme rarity - a version of Survivorship Bias - among the “Big Techs”. Collectively, these five books, “Top N” Google Tech Talks (check YouTube) and - depending on your role - coding best practices (check their site) are collectively a combination of top notch combined technical and business education in itself.Very rarely I give a 5-star rating to a technical book, but SEaG is completely worth the two weeks I immersed myself into learning Culture, Processes and Tools of Google Software Teams. The writers are deeply knowledgable, passionate about their crafts and offer insight after insight into topics ranging from human psychology to the flaws of over-embracing mock testing.Not targeting on algorithm, language, tools or libraries, it focuses on “Software Engineering” as a system, i.e., stuff that is not taught at any school. The book disambiguates “programming” from “engineering”, and walks through the hardest engineering challenge - how to scale.It also offers a treasure of insights and ideas from how Google made a billion lines of code change at one time, or how its automated tests could successfully process 50,000 change requests a day, or how Google Production System is perhaps one of the best machines humans ever engineered. Even if you are working nowhere near Google scale, the book covers a lot of fundamentals, especially on how to sustainably develop software and make objective trade-offs while doing so. I would very highly recommend SEaG to any engineering leader trying to improve her team's game. For developers, the four extensive chapters on testing should alone be worth the entry price.Notes from the "Culture" - first of three - part of the book (most of these should be organization agnostic) ----------------------------------------------------------------------------------------------------------------------------Software Engineering is “Programming integrated over time”. From a reverse lens, code thus becomes a derivative of Software Engineering.A project is sustainable if for the expected life span of the software, you are capable of reactive to valuable changes for either business or technical reasons.The higher the stakes, the more imperfect the trade-off value metrics.Your job as a leader is to aim for sustainability and managing scaling costs for the org, the product and the development workflow.Hyperbolic Discounting - when we start coding, our implicit life-span assignment to the code is often in hours or days. As the late 90s joke went - WORA - Write Once, Run Away!Hyrum’s Law: With a sufficient number of users of an API, all observable behavior of your system will depend on a random person doing a random thing. Conceptually similar to entropy - your system will inevitably progress to a high degree of disorder, chaos and instability. I.e., all abstractions are leaky.Two spectrums of code - one way is hacky and clever, another is clean and maintainable. The most important decision is to ensure which way the codebase leans. It is programming if ‘clever’ is a complement, and software engineering if ‘clever’ is an accusation!Google's SRE book talks about the complexity of managing one of the most complex machines created by humankind - Google Production system. This book focuses on the organization scale and processes to keep that machine running over time.Scaling an org means sublinear scaling with regard to human interactions.The BeyoncĂ© rule: “If you liked it, you should have put a CI test on it”. i.e., if an untested change caused an incident, it is not the change’s fault.An average Software Engineer produces a constant number of lines of code per unit time.Treat whiteboard markers as precious goods. Well functioning teams use them a lot!60-70% developers build locally. But Google built its own distributed build system. Ultimately, even the distributed build gets bloated - Jevon’s Paradox -- consumption of a resource increase as a response to greater efficiency in its use.Humans are mostly a collection of intermittent bugs.Nobody likes to be criticized, especially for things that aren’t finished.DevOps in one sentence: Get feedback as early as possible, run tests as early as possible, think about security & production environments as early as possible - also known as “left shifting”.Many eyes make all bugs shallow. Make reviews mandatory.Three Pillars of Social Interaction - Humility, Respect, Trust.Relationships always outlast projects.You have two paths to choose from - one, learn, adapt and use the system; two, fight it steadily, as a small undeclared war, for the whole of your life.Good Postmortem output - Summary, Timeline, Proximate Cause, Impact, Containment (Y/N), Resolved (Y/N) and Lessons Learned.Psychological safety is the biggest thing in leading teams - take risks and learn to fail occasionally.Software engineering is multi person development of multi-version programs,Understand Context before Changing things - Chesterton’s Fence is a good mental model.Google tends toward email-based workflows by default.Being an expert and being kind are not mutually exclusive. No brilliant jerks!Testing on the toilet (tips) and Learning on the Loo (productivity) are single-page newsletters inside toilet stalls.1-2% of Google engineers are readability (Code Review tool) reviewers. They have demonstrated capability to consistently write clear, idiomatic and maintainable code for a given language. Code is read far more than it is written. Readability (review tool at Google) is high cost - trade-off of increased short-term review latency and upfront costs for long-term payoffs of higher-quality code.Knowledge is the most important, though intangible, capital for software engineering org.At a systemic level, encourage and reward those who take time to teach and broaden their expertise beyond (a) themselves, (b) team, and (c) organizations.On diversity - Bias is the default; Don’t build for everyone. Build with everyone; Don’t assume equity; measure equity throughout your systems.A good reason to become tech lead or manager is to scale yourself.First rule of management? “Above all, resist the urge to manage.” Cure for “management disease” is a liberal application of “servant leadership”, assume you’re the butler.Traditional managers worry about how to get things done, whereas great managers worry about what things get done (and trust their team to figure out how to do it).Being manager - “sometimes you get to be the tooth fairy, other times you have to be the dentist”.Managers, don’t try to be everyone’s friend.Hiring: A hires A, while B hires C players.Engineers develop an excellent sense of skepticism and cynicism but this is often a liability when leading a team. You would do well to be less vocally skeptical while “still letting your team know you’re aware of the intricacies and obstacles involved in your work”.As a leader - Track Happiness - best leaders are amateur psychologists; Let your team know when they’re doing well; It’s easy to say “yes” to something that’s easy to undo; Focus on intrinsic motivation through autonomy, mastery and purpose; Delegation is really difficult to learn as it goes against all our instincts for efficiency and improvement.Three “always” of leadership - Always be Deciding, Always be Leaving, Always be Scaling.“Code Yellow” is Google’s term for “emergency hackathon to fix a critical problem”.Good Management = 95% observation and listening + 5% making critical adjustments in just the right place.To scale, aim to be in “uncomfortably exciting” space.All your means of communication - email, chat, meetings - could be a Denial-of-Service attack against your time and attention. You are the “finally” clause in a long list of code blocks!In pure reactive mode, you spend every moment of your life on urgent things, but almost none of it is important. Mapping a path through the forest is incredibly important but rarely ever urgent.Your brain operates in natural 90-minute cycles. Take breaks!Give yourself permission to take a mental health day.Everyone has a goal to be “data driven”, but we often fall to the trap of “anecdata”.Google uses GSM (Goals/Signals/Metrics) framework to select metrics to measure engineering productivity.QUANTS - 5 components of productivityQuality of code; Attention from engineers; Intellectual Complexity; Tempo (how quickly can engineers accomplish something) and velocity (how fast they can push their release out); SatisfactionQuantitative metrics are useful because they give you power and scale. However, they don’t provide any context or narrative. When quantitative and qualitative metrics disagree, it is because the former do not capture the expected result!Let go of the idea of measuring individuals and embrace measuring the aggregate. Before measuring productivity, ask whether the result is actionable. If not, it is not worth measuring.

Software Engineering at Google: Lessons Learned from Programming Over Time
⭐ 4.6 💛 583
kindle: $31.34
paperback: $22.99
Buy the Book