Products · Pattern or everyday thing
Developer documentation
Raised as a usability problem by 4 people on Hacker News over 16 years (2010–2025), in 4 threads.
People raised many different problems with Developer documentation, 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 4 complaints
- Outdated or missing docs make the developer experience abysmal and force people to give up2025-09-22
- Outdated presentations force readers to work out what has changed2021-06-13
- Docs cover the happy path but leave users stuck on unexplained error codes2019-11-12
- Fixed header takes most of the screen when font is enlarged, and breaks scrolling2010-12-06