Hacker Newsnew | past | comments | ask | show | jobs | submitlogin
From Readme to Docusaurus: How an Intern Saved Us $1.2k (reviewpad.com)
11 points by jack335 on Sept 16, 2022 | hide | past | favorite | 12 comments


This is a classic case of being overwhelmed by complexity, when in truth complexity is an advantage. SaaS services tend to be your biggest friend on the first month of usage, and them when you need more that's it, you're stuck to that.


Docusaurus is really fun to work with. Nice and fast, super configurable, and excellent documentation! If you're used to React it's a no-brainer, the sky is the limit.


You can't beat open-source. SaaS offerings usually try to generalize a service to serve the largest amount of people, when in fact what you want is solution to what your doing, not to what most people are doing.

When you're using open-source software it's very probable that you'll find people with the same problem you have, and in most of cases there will be a solution waiting for you already. Not to mention the cost savings too.


Thanks from the Docusaurus team ;)


Awesome!!! We're the ones thanking!


Docusaurus FTW! I have yet to try it, but it's come across my lense a lot lately. Deffo going to use it for my next docs site.


Great! Let me know if you have any question


We're actually looking for a static website platform, to use in tandem with Docusaurus. Any guides on how to do it with Docusaurus alone?


Not sure to understand what you mean here, can you explain?

Docusaurus is a static site generator, a bit similar to Gatsby. It's opinionated toward docs/blog/pages but you can also use it in a more generic way.


Indeed, that was it. I think maybe we'll give it a try!


My experience isotherm Readme has better support for Swagger compared to Docusaurus


You mean Openapi?

Docusaurus has at least 2 community openapi plugins

+ 1 Redoc community plugin

+ it's possible to build something custom with MDX,see Courier doc: https://www.courier.com/blog/how-we-built-our-documentation/

What is missing exactly?




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

Search: