Products · Broad category
API documentation websites
Raised as a usability problem by 6 people on Hacker News over 11 years (2015–2025), in 6 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 API documentation websites, 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 6 complaints
- Reference docs don't explain a parameter's conditional behavior, so hours are spent guessing2025-10-10
- Keyboard-only navigation is broken, forcing mouse use to pick search options2024-05-27
- Documentation website cannot be read on mobile devices2022-11-26
- Documentation text has too low contrast to read2022-03-31
- Page is extremely annoying to read on mobile2017-02-22
- Hover sidebar at some widths hides API definition at bottom, so user thinks clicks don't work2015-05-26