Products · Pattern or everyday thing
README files
Raised as a usability problem by 4 people on Hacker News over 6 years (2019–2024), in 3 threads.
People raised many different problems with README files, but no single problem has yet been raised by 3 people in 3 different months and threads.
Unreviewed issues were grouped by machine: Claude Haiku labelled each comment as a usability complaint, named what it's about and summed up the problem in a line, and a small model grouped similar problems. Nobody has checked them by hand. Expect mistakes.
The newest 5 complaints
- Too much friction to get most people to write docs in the repo2024-02-14
- Each documentation set needs a separate project, so maintenance and settings sharing become hard at scale2021-11-19
- Visitors can't tell what the product does without signing up2019-08-29
- Couldn't find real screenshots or example links on docs pages2019-08-29
- Documentation link leads to marketing page, not actual product docs2019-08-29