2026-10-07 11:57 UTC
I'm currently paying people to test my README.
Using my #NLnet grant money, I'm giving people a €25 voucher if they'll let me watch them try to follow my documentation and install my software.
It is *painful* but brilliant. I've found so many issues that I'd never thought of before. Only by hearing people sigh in frustration at your clumsy prose will you be able to improve things.
You don't have to pay people, of course,. Ask a friend if you can watch them install your code.
It is revelatory.
Replies (2)
-
@dajb@social.coop 2026-10-07 11:59
@Edent@mastodon.social Reminds me of @Downes@mastodon.social doing 'Stephen follows instructions' https://www.youtube.com/playlist?list=PLeBQHgzQN9x3Ef-JuV-HQw2on-_RkjTBM
-
@emily_s@mastodon.me.uk 2026-10-07 12:08
@Edent@mastodon.social oh goodness I bet this is a brutal teacher. As a writer friend says "kill your darlings"