Hacker News Reader

Comment by sixhobbits | Hacker News Reader

I've tried most of these and this is definitely one of the best, especially since the latest version. It's not too heavy but includes all the features you don't know you need at the start, and a good ecosystem of plugins and extensions.

Other notable mentions are

- mkdocs-material, if you prefer python to js

- astro starlight, not quite as mature and a bit heavier but looks nicer out the box and includes built-in search

View on HN

What makes starlight heavier? If anything its the opposite, it's not client side rendering pages like Docusaurus... https://starlight.astro.build/environmental-impact/

Likewise, I've been happy with Starlight and trust Astro products to be lightweight and efficient. I'm interested in knowing what makes it heavier

The comparisons-page clearly highlights that Docusaurus is way heavier. https://starlight.astro.build/environmental-impact/#comparis...

Are there any good open source documentation chatbots that you can integrate into the search function of docusaurus? If you see commercial offerings like mintlify, they all come with a Q and A chatbot built-in. It’s not very hard to build, you just need to generate the RAG chunks at build-time but this is best implemented as part of the documentation software, rather than as a third party plugin since it heavily ties into the search feature.

+1! I'd love to know, too!

Mkdocs-material has been my go to for this use case. However, I once made a document website using MDbook(the thing that Rust uses for their own documentation and book), and have a lot of happy consumers.

mkdocs-material is fine if you prefer Python to JS, but I personally very much dislike how it looks, and as everything else it uses a weird custom Markdown flavor where indentation is handled weirdly which can create edge-cases where for example a valid GFM list is not rendered properly by MkDocs.

+1 on Starlight, though, it is my go-to and I absolutely love it.

Reply on news.ycombinator.com