Products · Pattern or everyday thing
Technical documentation
Raised as a usability problem by 8 people on Hacker News over 9 years (2018–2026), in 6 threads.
People raised many different problems with Technical 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 8 complaints
- Documentation is barely comprehensible to readers because of poor English and bad content2026-01-16
- Docs are dry, passive, and lack diagrams or getting-started tutorials, so they are hard to understand2023-02-22
- Docs read like a schema, so finding a quick how-to answer is hard2022-06-15
- Right-hand sidebar disappears after refreshing the page2021-05-27
- Search icon shows 'initialising search' and never changes, so user thinks it's broken2021-05-27
- Sidebars appear and disappear inconsistently depending on zoom and refresh2021-05-27
- Most current technical documentation is hard to use, compared to VMS help2019-08-20
- Complex code examples are hard to decipher and extract the needed bits from2018-05-25