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

I'm not belittling all other tools, just MdWiki (and Docsify that I consider in the same category of client-side JS, hash-based docs tool).

All the other docs tools are great too, and I'm not saying Docusaurus is better. I believe Docusaurus can scale from small sites to very advanced doc sites with minimal effort.

If I were a Python dev looking for something simple but that remains quite flexible, I'd definitively try MkDocs.

If I were a Vue dev I'd try first VitePress/VuePress before Docusaurus. It has less features but a great UI design, some convenient Md features, and it's convenient for a Vue dev/team to reuse their existing VueJS knowledge.

If I had a Next.js site and wanted to integrate docs feature in the same site, I would try Nextra.

Really, apart my comment on MdWiki (which I still stand by: most of you shouldn't use it), I think I'm fair with all the other tools?



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

Search: