Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

My team uses Docusaurus for internal docs. I just had to make my first contribution to that repo the other day, and it was a mess. Docusaurus didn't work from within WSL (well, it mostly worked but every page load crashed when viewing), so switching to native Windows NPM and the several dependencies and installation steps to get it working took about a half hour with the help of a colleague who knew how it worked. And ultimately, it was just so I could write markdown.

The generated docs are nice, to be sure, but I certainly would not go through that pain if I had to go documentation from scratch.



Hey, Docusaurus even works in your browser

docusaurus.new

I'm not sure why you went through all this pain, but if you don't report it, how can we fix it? Others do not have the same experience afaik.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: