The Onboarding Olympics: Why We Made Engineers Race to Set Up Each Other’s Repos

This post details the 'Onboarding Olympics' initiative, a competitive event designed to expose flaws in developer onboarding and documentation. It highlights specific failure modes such as READMEs lying by omission, the persistence of dead configuration (e.g., old Docker Compose files), the problematic use of shell scripts for setup, IDE assumptions in documentation, and the fragility of relying on external QA environments for local development. The post provides a playbook for running similar events, emphasizing contestant selection, time limits, spectator involvement, and regular cadence. It also notes the direct impact on teams, forcing them to confront and fix issues like outdated Docker Compose files.