Investing in Internal Documentation: A Brick-by-Brick Guide for Startups
David Nunez, an early hire at Stripe and Uber, shares his step-by-step playbook for establishing good internal documentation habits at your startup. He unpacks his tested tactics for creating a culture of documentation, setting the quality bar and keeping things organized. It’s the middle of the night when the on-call engineer jolts awake as their phone flashes and chimes with a flurry of push notifications, text messages, and phone calls. The production server is down and they’re responsible for getting it back up as fast as possible. With bleary eyes and a foggy mind, the engineer frantically searches for answers in Slack, Google Docs, and GitHub but they only turn up vague mentions of the error. With no meaningful information to orient around, they’re forced to wait anxiously for one of the veteran engineers to wake up as the outage drags on. Mission-critical knowledge trapped in an early hire’s head is an all-too-common problem that startup engineering orgs know well. But investing
It’s the middle of the night when the on-call engineer jolts awake as their phone flashes and chimes with a flurry of push notifications, text messages, and phone calls. The production server is down and they’re responsible for getting it back up as fast as possible. With bleary eyes and a foggy mind, the engineer frantically searches for answers in Slack, Google Docs, and GitHub but they only turn up vague mentions of the error. With no meaningful information to orient around, they’re forced to wait anxiously for one of the veteran engineers to wake up as the outage drags on. Mission-critical
Explore this link on the map →related reading
- How Stripe creates the best documentation in the industrymintlify.com
- How Stripe Built a Writing Culture - Knock Down Silos by Slabslab.com
- The Kool Aid Factory :: Writing In Public, Inside Your Companykoolaidfactory.com
- Startup Playbookplaybook.samaltman.com
- Brown M&Ms, or why no one's reading the manual | Inside Nuclinoblog.nuclino.com
- Design Docs at Googleindustrialempathy.com
- How to Start a Startuppaulgraham.com
- Memossriramk.com
- You don’t have to be a founder | MIT Admissionsmitadmissions.org
- What "The Best" Looks Like | Alex Kurilinkuril.in
- Writing an engineering strategy. | Irrational Exuberancelethain.com
- The Hardest Lessons for Startups to Learnpaulgraham.com