I paid people to try and follow my README
The author of a popular GitHub repository, shkspr, paid people to try to follow their README file to see how many of them would actually follow the instructions. The README file contained a series of unusual and time-consuming steps, including writing a poem, creating a Google Form, and solving a math problem. Only 1 out of 12 participants managed to complete the task correctly. The author found that most people would give up or get stuck at various points, often due to a lack of clear instructions or a failure to follow the instructions carefully. This experiment highlights the importance of clear and concise language in documentation.
Read the full article at shkspr.mobi →