Helping people become productive.
WHAT TO PROVIDE
Setup instructions that actually work An overview of the structure and why it is that way The conventions Where the design system lives How to run, test and deploy
WHAT TO TEST
The setup instructions, by having someone follow them from nothing.
WHAT THAT REVEALS
Every step that was never written down.
WHAT TO EXPLAIN
The decisions: why this framework, this state approach, this structure.
WHY
Without reasons, people work around conventions they do not understand.
WHAT TO ASSIGN FIRST
Something small, real, and end to end.
WHY
It exercises the whole workflow.
WHAT TO PAIR THEM WITH
Someone who answers questions without making them feel foolish.
WHAT TO ENCOURAGE
Questions, and noting anything confusing.
WHAT TO DO WITH THOSE NOTES
Fix the documentation.
WHY
A newcomer is the only person who can see what is unclear.
WHAT TO REVIEW
Whether the documentation improved after each arrival.
