Mmastodon first seen 13 h ago, last 14 min ago, peak #4
Terence Eden on how to actually test your README
Original: How to *actually* test your readme
Blogger Terence Eden argues that most open-source README files are never properly tested, walking through the familiar frustration of following install instructions that break at every step — from unarchive problems to setup scripts that fail. He suggests developers should verify their documentation by following it from scratch, the way a new user would, rather than assuming it works.
Why now: It taps into a widely shared frustration among developers with poorly tested open-source documentation.
Rank over time, top of the chart is #1. 53 snapshots from 13 h ago to 14 min ago.
Evidence
- How to *actually* test your readme · Terence Eden’s Blog
If you've spent any time using Linux, you'll be used to installing software like this: The README says to download from this link. Huh, I'm not sure how to unarchive .tar.xz files - guess I'll search for that. Right, it says run setup.sh hmm, that doesn't work. Oh, I need to…
API: https://socialmediatrends-api.osmike.com/v1/trends/1363628