When a new person joined the company, the default onboarding plan was another person. A senior colleague sat with them, walked them through the initial setup, answered questions, and showed them where to start.
As the company grew, the team repeated the same walkthrough every time someone joined. The result depended on who was available and what they remembered to explain. Two people joining in the same month could receive very different introductions to the same system.
I led a codelabs program at a large enterprise to make this process repeatable. Here’s how we approached it.
What we put into codelabs
We moved the repeatable setup into codelabs. New hires could follow the common path independently, without waiting for someone to walk them through each step.
Pairing still mattered. Senior colleagues provided context, answered difficult questions, and explained the decisions behind the system. The codelabs covered the basics, leaving mentors available for questions that needed their experience.
Choosing the first tasks
We listed the tasks a new hire handled in the first few weeks and used those to scope the documentation. Many of those workflows were common across teams. They crossed several systems and ownership boundaries, where reference docs leave gaps.
We started with a small set of codelabs covering the most common first-month tasks.
A common format
Every codelab followed the same structure: a real scenario, a clear starting point, one supported path, checkpoints, and a reference solution.
With a thousand people working through the exercises, a common format helped learners know what to expect. It also made the codelabs easier to review and maintain.
I covered this structure in what makes a good codelab.
What changed
The first task no longer took three weeks. New hires could follow the documentation and ship their first change without waiting for a senior engineer to walk them through it.
Mentors spent less time repeating setup. Everyone completed the same exercises, so the team also gained a shared baseline. When someone said, “I did the onboarding codelab,” everyone knew what they had learned.


