flâneur — a map of the web's best reading

Investing in Internal Documentation: A Brick-by-Brick Guide for Startups

review.firstround.com · 5,404 words · saved by 1 readers

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