Why the onboarding wiki rarely gets read

Every company has one. A “start here” page with a friendly title and fourteen links underneath it.

It’s not a bad page. Someone worked hard on it. Every link goes somewhere useful. And almost nobody reads it the way it was intended, because on Day 2 a new hire has no way of knowing which of those fourteen things matters this week and which can wait until month three.

So they skim. They open a few tabs. They ask a colleague. And they quietly assume everyone else understood something they didn’t.

That isn’t a motivation problem. It’s a design problem.

A wiki is a library, not a lesson

Wikis are good at storing information. They’re bad at three things a new person actually needs.

Order. What should I learn first? A list of links gives everything the same weight.

Confirmation. Did I get it? Reading a page tells you nothing about whether it landed.

Progress. How far along am I? Without some sense of progress, onboarding feels endless, and people stop.

None of these are solved by writing better pages. They’re solved by changing the format people meet the content in.

Smaller is better

The most useful thing I’ve learned building onboarding content is to make each piece small enough to finish between meetings. One idea. A short explanation. A quick check that it made sense. Then a link to the full detail for anyone who wants it.

That keeps the wiki as the source of truth, which matters more than it sounds. The moment you copy content into a second place, you own two versions, and one of them is wrong within a quarter.

Why I made ours a game

For us, the format that solved order, confirmation, and progress all at once turned out to be a game: a small map, short levels, stars that unlock the next area, and real colleagues as the guides. You can read how I built it.

But the game isn’t the point. It’s one answer to a broader question every people team should ask about its onboarding content: does this tell a new person what matters first, and how will they know they’ve got it?

If the honest answer is “they’ll figure it out,” some of them will. The rest will spend their first month guessing, and you’ll find out at the 30-day check-in, if you’re lucky.

Three questions to ask about your own onboarding

• Could a new hire tell you, on Day 2, the three things they need to understand this week?
• Is there any moment where they find out whether they understood something, before it matters?
• Do they ever get a sense of how far along they are?

If the answer to all three is no, the content probably isn’t the problem. The packaging is.