# Why use a self-serve onboarding wiki New hires should not need insider knowledge to find a first-day schedule, request software access, or identify approvers. Those answers are often scattered across email, chat, shared drives, and poorly named documents. A single onboarding wiki gives employees a reliable place to start and reduces avoidable delays—but it must be designed to support learning, not replace human judgment or managerial feedback.
# What the wiki must do
# Plan the first month Map the onboarding journey before you create pages. Sequence matters.
- Preboarding: first-day schedule, equipment arrangements, primary contact, secure sign-in details. Avoid sending confidential internal material to a personal email if company access will be delayed.
- Day one: essential accounts, security expectations, introductions, manager meeting.
- Week one: role expectations, working norms, and a small real workflow task.
- Later weeks: detailed procedures, finished examples, decision boundaries, and the first meaningful deliverable.
# Structure the wiki around user questions Organize the front door around new-hire questions, not departmental folders. Suggested areas and likely owners:
- Start Here: onboarding route, first-day plan, key contacts — People Operations.
- How We Work: communication norms, meetings, hours, decision rules — Operations/People teams.
- People and Teams: team map, responsibilities, approval routes — department leaders.
- Tools and Access: approved tools, access requests, setup help — IT or Security.
- Role Hubs: expectations, procedures, templates, examples — hiring manager or team leads.
- Policies and Support: leave, expenses, conduct, benefits, support — HR.
# Write actionable pages Pages should answer specific questions, for example "How to request software access" rather than "IT resources." For procedures include who it covers, prerequisites, steps, expected result, owner, review date, and help route. An access page should name the ticket form, required details, approval path, and response channel. Avoid vague instructions like "contact IT" without a clear path.
Use screenshots with written steps and give training videos a summary and links to forms shown.
# Make search effective People search with different terms ("holiday," "annual leave," "PTO"). Include common alternatives in titles or tags. Maintain one main page per subject and archive duplicates. Test the structure by asking someone unfamiliar to find leave or access procedures.
# Protect sensitive information Keep confidential HR cases, personal data, and internal security keys out of publicly visible pages. Use correct permissions and local pages for country-specific employment details.
# Keep human support and maintain the wiki Self-service should reduce queues, not discourage questions. Repeatedly telling a new hire to "check the wiki" can shift too much responsibility onto the newest person. Include named contacts, onboarding buddies, and manager checkpoints. Maintain owners, review dates, and a process for archiving or updating pages so instructions remain current.
# Mistakes to avoid Do not launch with disorganized titles, duplicate instructions, unclear ownership, or no search strategy. Moving to a new platform won't fix weak content. Don't promise turnaround times without an actual service standard.
# Final practical steps Start by mapping the first month, choose the few pages that solve immediate needs (first day, access requests, approvals), name owners, and test findability with someone new to the company. Iterate based on the questions people keep asking.