Products · Broad category
Programming language documentation
Raised as a usability problem by 5 people on Hacker News over 11 years (2012–2022), in 5 threads.
This is a broad category rather than one product, so its issues aren't ranked on the home page.
People raised many different problems with Programming language 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 5 complaints
- Bit vector operations are confusing because you must work with the underlying number representation2022-09-30
- English keywords are cumbersome and block natural variable names2021-03-06
- Every string must be explicitly quoted, adding clutter to configuration files2015-03-11
- Cryptic function names like fnext and rseq can't be guessed2014-02-10
- Documentation omits parameters, callbacks, return values and exceptions, forcing users to guess or experiment2012-09-28