Engineering Decisions

Documentation¶

Link	Notes
Design Docs at Google	Anatomy of a good design doc
Design Docs, Markdown, and Git	Related to the above, how to treat design documents as code
Architecture decision record (ADR)	An architectural decision record (ADR) is a document that captures an important architectural decision made along with its context and consequences
What is the best way to write a PRD?	Anatomy of a good PRD (Product Requirement document), a document that tells you what exactly you are building Plus, PRD examples from top companies
Scaling Engineering Teams via RFCs: Writing Things Down	The power of writing things down, and spreading knowledge across the organization
Technical Writing Courses for Engineers from Google	Collection of courses and learning resources aims to improve your technical documentation Refers to the Google Developer Documentation Style Guide
S.P.A.D.E. Toolkit: How to implement Square's famous decision-making framework	A decision-making framework, alternative to consensus built on accountability and clarity, where the person responsible for executing the decision is the one who decides

Link	Notes
AWS App-Layer Encryption in AWS
AWS Network access for private clusters	Very interesting article going into the problem of providing network connectivity between Kubernetes clusters and other internal tools (like deployment pipelines)
AWS Square Adopting AWS VPC Endpoints at Square	Secure communication between data centers and the cloud
AWS Square Providing mTLS Identities to Lambdas	Writeup on how Square added support for mutual TLS calls from AWS Lambda into their data center
AWS Square Expanding Secrets Infrastructure to AWS Lambda	How Square extended their datacenter-based secrets infrastructure to enable a cloud migration supporting Lambda
AWS Cloud Encryption is worthless! Click here to see why...	When evaluating your cloud security posture priorities, encryption should be at the bottom of your list. First, get your IAM house in order
AWS Building the Next Evolution of Cloud Networks at Slack	How Slack has gone through an evolution of their AWS infrastructure from running a few hand-built EC2, all the way to provisioning thousands of them across multiple AWS regions

Link	Notes
Automating Our Infrastructure to Empower Engineers	Syncing Dev Environments Mirroring Dev and Prod Environments Developing Locally Deploying to Production
Why We Leverage Multi-tenancy in Uber's Microservice Architecture	Testing in production: make the current production stack multi-tenant and allow both test as well as production traffic to flow through it Canary deployments: a canary can be treated as yet another tenant in a multi-tenant architecture Capture/replay and shadow traffic: replaying previously captured live traffic or replaying a shadow copy of live production traffic in a hermetically safe environment is another use case of multi-tenancy
Container technologies at Coinbase: Why Kubernetes is not part of our stack	Container technologies also create a large set of challenges that must be overcome to prevent failures
Decentralized GitOps over multiple environments	How SAP Artificial Intelligence implements GitOps in their large-scale project spanning multiple environments
How we use HashiCorp Nomad	Reliability model of services running in our more than 200 edge cities worldwide
Uber Introducing Domain-Oriented Microservice Architecture
Design Considerations at the Edge of the ServiceMesh	Set of design patterns around inbound and outbound traffic to and from a service mesh
A Kubernetes engineer's guide to mTLS	What mTLS is, how it relates to ordinary TLS, and why it's relevant to Kubernetes

Link	Notes
Why is it so hard to decide to buy?	If it isn't related to your core business No one else has an offering or one that is any good for you to use You shouldn't build a better solution, you should ask yourself why no one else needs to solve this problem