Writing Documentation That Survives a Reorg
Templates and habits that keep docs useful when the team that wrote them moves on.
8 posts — Engineering manager and recovering QA lead. Sam writes about testing, code review, and building teams that ship calmly.
Showing 8 posts
Templates and habits that keep docs useful when the team that wrote them moves on.
Forty minutes designing a URL shortener, with commentary on what interviewers look for.
Six desks, six time zones, and one shared love of good lighting.
Why intermittent failures deserve a ticket, an owner, and a deadline.
The four charts that survived after we deleted twenty others.
Open the trace viewer and step through a failing test action by action.
Stable screenshots through fixed fonts, frozen time, and masked regions.
Our twenty-item checklist slowed reviews down. Here is the three-question version that replaced it.