TechPrufer
Get started
Agoda
Agoda logoAgoda · Feature trail

Developer Onboarding and Documentation Hygiene

1 post · Feb 2026

What this trail covers

Agoda implemented a competitive 'Onboarding Olympics' event to rigorously test and improve the developer onboarding experience. This initiative directly addresses the gap between documentation (READMEs) and the actual system setup, revealing issues with outdated configurations, missing prerequisites, and unclear instructions. The event uses timed challenges where engineers attempt to set up unfamiliar repositories, with the owning teams observing live. This provides direct, actionable feedback, leading to improved documentation and setup processes.

All Agoda trails
  1. The Onboarding Olympics: Why We Made Engineers Race to Set Up Each Other’s ReposThis 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.