4 ms·

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

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

reacharavindh 2y ago
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.
Onavo 2y ago
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.
- bnlxbnlx 2y ago
  +1! I'd love to know, too!
FireInsight 2y ago
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.
lloydatkinson 2y ago
What makes starlight heavier? If anything its the opposite, it's not client side rendering pages like Docusaurus... https://starlight.astro.build/environmental-impact/ https://starlight.astro.build/environmental-impact/
- thibaultamartin 2y ago
  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
- FireInsight 2y ago
  The comparisons-page clearly highlights that Docusaurus is way heavier. https://starlight.astro.build/environmental-impact/#comparisons https://starlight.astro.build/environmental-impact/#comparis...

reacharavindh 2y ago

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.

Onavo 2y ago

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.

bnlxbnlx 2y ago
+1! I'd love to know, too!

FireInsight 2y ago

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.

lloydatkinson 2y ago

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

thibaultamartin 2y ago
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
FireInsight 2y ago
The comparisons-page clearly highlights that Docusaurus is way heavier. https://starlight.astro.build/environmental-impact/#comparisons https://starlight.astro.build/environmental-impact/#comparis...