Hacker News new | ask | show | jobs
by thiht 1865 days ago
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.

2 comments

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?