Docusaures isn't the best documentation tool out there, that's true. And of course building your own thing is nice, and it looks great.
But wouldn't the better option be, to just use Starlight (my preference), Vitepress or Nextra?
Because a "simple" docs site takes weeks or months of work that you could invest into other projects instead.
What about Starlight or Vitepress is humongous? In this case the downsides don't outweigh the upsides, at least that was my first thought, hence I asked.
Got you, I think the article made it clear that this solution did in fact not take months of work, as the heavy lifting is done by pandoc. The resulting solution is also very simple and can be understood completely in a short amount of time (very big upside). A framework based on node, typescript, npm etc. is by humongous by default.