The Monthly Onboarding Update Discipline

Onboarding docs rot. The 30-minute monthly discipline that keeps them current and the new-hire feedback loop that surfaces gaps.

The feedback loop

Onboarding docs decay because the people who wrote them stop reading them. The feedback loop fixes that by making new hires the auditors.

• 30-day note. Every new hire keeps a running 'things that confused me' note for their first 30 days.
• Hand-off. After 30 days, the note goes to the doc owner; each item is a gap to fix.
• Visible response. Owner addresses gaps in the next monthly update; new hires see their feedback land.
• Cumulative. Six new hires per year produce six rounds of fresh feedback; the doc trends current.

Monthly 30-minute review

The monthly review is the discipline that compounds. Thirty minutes a month beats a quarterly heroic rewrite that never ships.

• Cold read. Owner reads the doc as if seeing it the first time; flags anything ambiguous or out of date.
• Screenshot check. UI screenshots drift fastest; any screenshot older than the last UI ship needs replacement.
• Small batches. Most months: 5 to 10 changes; the cumulative effect over a year is substantial.
• Stale flag. Section untouched in 6 months and not in a stable area: suspect; investigate.

Avoid

Three patterns guarantee onboarding docs rot. Each one looks reasonable in the moment and corrosive over a year.

• Quarterly rewrite plan. 'We will rewrite the docs from scratch next quarter' never happens; small updates compound.
• Marketing voice. Onboarding docs are technical and dry; that is correct; do not tone-polish them.
• Cover everything. The doc points to source-of-truth references; it is not the truth itself, and trying to be makes it stale faster.
• One owner forever. Rotate the owner annually; fresh eyes catch what familiarity hides.