The Pragmatic Engineer

Share this post

Engineering Planning with RFCs, Design Documents and ADRs

newsletter.pragmaticengineer.com

Engineering Planning with RFCs, Design Documents and ADRs

What are some successful planning approaches engineering teams use as they grow?

Gergely Orosz
Jun 21, 2022
92
13
Share this post

Engineering Planning with RFCs, Design Documents and ADRs

newsletter.pragmaticengineer.com

Q: As our engineering team grows, we feel the need to do more written planning. Which approaches do tech companies use and how do they work?

The question of whether to document engineering planning is an evergreen one. This issue walks through examples of what certain tech companies do and it attempts to showcase some popular approaches. The newsletter closes with advice on how to decide which formats to choose.

Topics:

  1. Uber’s evolution of planning processes

  2. RFCs, Design Documents

  3. Reviewing RFCs

  4. Architecture Documents

  5. Sourcegraph and RFCs

  6. Stedi: RFCs and Decision Records

  7. Design Docs at Google

  8. Examples of RFCs, and companies that use an RFC-like process. See these in a separate article here.

For the rest of this article, I use the term RFC (Request for Comment) to refer to any type of engineering design document, for simplicity.

This post is for paid subscribers

Already a paid subscriber? Sign in
© 2023 Gergely Orosz
Privacy ∙ Terms ∙ Collection notice
Start WritingGet the app
Substack is the home for great writing