Products · Broad category
Project documentation
Raised as a usability problem by 14 people on Hacker News over 10 years (2017–2026), in 13 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 Project 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 14 complaints
- Documentation is hard to read, full of verbose AI-style text2026-09-11
- Docs render badly on iPhone Safari; sidebar doesn't restyle for small screens2024-09-29
- Dev workflow setup is non-obvious, fiddly, and often missing from project docs2024-06-04
- On mobile, search bar and table of contents fill the screen, hiding the content2024-06-04
- Unclear whether the API must be used or is just development docs2023-01-10
- Docs lack setup info, so contributors waste hours figuring out how to build2022-09-30
- Can't get project running locally; docs are only videos, outdated and incomplete2022-08-12
- Must sit through full recordings instead of seeing commands in an overview2021-11-30
- Docs are hard to navigate, at least on mobile2021-11-30
- Shell prompt characters in examples get copied along, making commands hard to copy-paste2021-07-21
- Documentation pages are hard to search, so people often skip checking for a search feature2021-01-30
- Installation instructions hidden inside subcrate pages rather than the main repo2020-12-06
- Hard to find how to call a function; no table of contents or index2020-09-30
- Official sites give vague intros and hard-to-find descriptions, forcing outside searches2017-12-11