MikeTrendsTrends right now

Yhn SportBaseball first seen 17 h ago, last 38 min ago, peak #2

Developer pays testers to follow his README instructions

Original: I paid people to try and follow my README

A software developer has described paying strangers to attempt to set up a project using only his README documentation, then watching where they got stuck. The experiment highlights a common gap between how maintainers write setup guides and how newcomers actually experience them. Readers are discussing whether documentation should be usability-tested like software, and sharing their own onboarding failures.

Why now: The unusual experiment of usability-testing documentation resonates with developers who struggle with unclear READMEs.

Terence EdenREADMEopen source software

Open on hn →

Rank over time, top of the chart is #1. 56 snapshots from 17 h ago to 38 min ago.

Evidence

Elsewhere

API: https://socialmediatrends-api.osmike.com/v1/trends/1855500