frontend
How to Onboard a New Dev Without Overwhelming Them
Thoughts from the intersection of code, craft, people, and progress.
Give them room to breathe—and a buddy to call.
New starters need context, but giving them all of it on Monday morning is not the same as helping. Good onboarding introduces the right information gradually, provides safe early work and makes it obvious where to ask the questions nobody thought to document.
Onboarding is the first real test of a team's documentation, defaults and assumptions. When a new person gets stuck, they are often discovering friction everybody else has simply learned to step around.
I have learned to be suspicious of advice that only works in a tidy example. Real projects come with history, deadlines, uneven confidence and requirements that move while you are looking at them.
The leadership part is rarely the grand speech. It is the ordinary environment around the work: whether people can ask an awkward question, whether priorities stay still long enough to act on them, and whether useful effort is noticed.
The details will change from project to project. The underlying habit of paying attention travels well.