Not OP, but I was looking for documentation-oriented static site generator some time ago. In my experience:
* There's usually mess in documentation for JS-based ones. For eg. "quick start" section of the docs uses npx. Then full installation manual uses entirely different commands. JS is not my main technology so it's very confusing.
* Builds tend to be significantly slower when npm is involved.
* Plugins and themes very often have compatibility issues.
* They tend to use mdx, which is not necessarily very well supported outside of JS world and some solutions break when you try to bring your existing markdown.
I'm aware that:
* None of this is inherently JS property.
* Docusaurus is actually not guilty of most of these issues and I would recommend it.
* Probably it all makes sense/is avoidable, when you work with this ecosystem often.
However I'm just trying to setup documentation page, not start new carrer patch and non-JS based solutions are usually better on understanding that.
* There's usually mess in documentation for JS-based ones. For eg. "quick start" section of the docs uses npx. Then full installation manual uses entirely different commands. JS is not my main technology so it's very confusing.
* Builds tend to be significantly slower when npm is involved.
* Plugins and themes very often have compatibility issues.
* They tend to use mdx, which is not necessarily very well supported outside of JS world and some solutions break when you try to bring your existing markdown.
I'm aware that:
* None of this is inherently JS property.
* Docusaurus is actually not guilty of most of these issues and I would recommend it.
* Probably it all makes sense/is avoidable, when you work with this ecosystem often.
However I'm just trying to setup documentation page, not start new carrer patch and non-JS based solutions are usually better on understanding that.