Like CI, onboarding is a process we get better at by doing. If I work some place that hires consistently, I’ll make sure to sit with a new engineer at least once a year to 18 months and observe them going through the documented process. Save them when they get stuck, and rephrase that part of the documentation.

I’ll also prompt them to make changes as well, for one very particular reason: when you encounter a jargon term for the first time maybe the first half dozen times, you still have Beginner’s mind. You can still explain it to someone below you on the ladder. Senior staff can get trapped in circular definitions and unspoken assumptions.

Generally speaking, I find that the people who hate ramping up new engineers have made a mess that they don’t like to think about, and onboarding makes them look at it.