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

I wanted to love Docusaurus because I'm more of a React guy and I like MDX, but I think Vuepress is better for writing a good documentation.

Something in Docusaurus feels off. When you install it, you're not ready to go, there are a lot of things to clean and remove because it seems to be very tied to Facebook's use.

Maybe it's just me though.



What theme are you using with Docusaurus? The classic theme (default). I am curious what you are seeing that is Facebook-specific that you are cleaning up. Would love to hear the feedback. Thanks!


I remember removing the /blog part was tedious, because there were links in a lot of places. And once I removed it, it didn't build anymore.

I'll give it another shot and see if I have the same feeling, if so I'll write a feedback


For sure, our init template contains a blog.

You can definitively remove it ("blog: false" in preset config).

If you remove it, you also need to remove the links to the blog, because it would lead to 404 errors.

Docusaurus is fail-fast by default and try to prevent you to deploy broken sites, I understand how it can be annoying in some cases but consider it an useful feature


I didn't know about the config parameter, is it recent? I don't remember finding it when I tried to remove it.


not new, we have many sites that are just using the blog, or just using the docs.

Example of just using the blog: https://blog.johnnyreilly.com/ https://blog.developersam.com/


That looks weird to me.

Can you list any of those things that are tried to Facebook's use?




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

Search: