News for hackers. Stuff that matters.

A comment on I paid people to try and follow my README.

Re:I paid people to try and follow my README by theletterf on Sunday October 11, 2026 @09:03AM (#50042925)
Besides emojis, I find it too long. READMEs should be succinct and be like a switchboard to other docs (much like LLMS.txt tries to be for agents).

Also, it features an FAQ. FAQs are problematic (as in not often effective): https://passo.uno/what-the-faq/

Edit: Clarification

[ Parent | on HN ]
Re:I paid people to try and follow my README by saghm on Sunday October 11, 2026 @09:12AM (#50043003)
The link says "My opinion is that FAQs pose a problem only when there’s no strategy around their usage." Calling them "problematic" based on that seems like an exaggeration
[ Parent | on HN ]