I paid people to try and follow my README
Summary
Terence Eden describes paying real users (€25) to test the first-run experience of the ActivityBot README. He recounts sessions where participants share their screens and verbalize their confusion, highlighting issues like mislinked tools, naming clarifications, and the need to explain what the software does. The article argues that human feedback can significantly improve documentation more effectively than relying on AI simulations.