Docusaurus

Raised as a usability problem by 6 people on Hacker News over 5 years (2021–2025), in 4 threads.

People raised many different problems with Docusaurus, 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

Builds on large documentation sites are very slow, timing out CI runners2025-05-28
Crashes on page load under WSL, forcing a half-hour workaround to get it running2022-08-01
Requires client-side JS, so it is inaccessible and shows unstyled content flashes2022-08-01
Adding a page takes many manual steps: file, frontmatter, sidebar JSON, dev server reload2021-11-18
Build process is slow and complicated with many moving parts2021-05-12
Floating action button menu on mobile is confusing and unintuitive for users2021-05-12