Hacker News Reader

I’ll add another:

“Follow these steps and if something doesn’t work figure out the solution and update the document”.

You mean "you and your onboarding buddy figure out the solution and update the document". It might just be me but I think it's a bit crazy to expect someone with less than 8 hours experience in the role to figure out issues that other team members either haven't noticed or chose to ignore.

This seems like the right thing to do. Lets the newcomer be useful and gets the documentation to have guaranteed recent knowledge. If it's an antipattern it's because too many people don't like documentation and don't update it.

I've hit this. It's kind of a tragedy of the commons scenario:

If I take the time to fix the docs with a high certainty of accuracy, I get behind on other stuff with getting credit for the fix.

I guess it also comes down to what the cultural norms / expectations are. Some might see it as natural in a growing company, others might see it as selfishness at the expense of new employees.

Reply on news.ycombinator.com