News for hackers. Stuff that matters.
Re:Docusaurus – Build optimized websites quickly, focus on y... by sixhobbits on Thursday August 29, 2024 @03:15AM (#41388178)
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

Re:Docusaurus – Build optimized websites quickly, focus on y... by FireInsight on Thursday August 29, 2024 @04:06AM (#41388451)
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.

Re:Docusaurus – Build optimized websites quickly, focus on y... by reacharavindh on Thursday August 29, 2024 @03:23AM (#41388222)
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.
Re:Docusaurus – Build optimized websites quickly, focus on y... by Onavo on Thursday August 29, 2024 @04:02AM (#41388431)
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.
Re:Docusaurus – Build optimized websites quickly, focus on y... by bnlxbnlx on Thursday August 29, 2024 @01:48PM (#41393435)
+1! I'd love to know, too!
Re:Docusaurus – Build optimized websites quickly, focus on y... by lloydatkinson on Thursday August 29, 2024 @05:00AM (#41388776)
What makes starlight heavier? If anything its the opposite, it's not client side rendering pages like Docusaurus... https://starlight.astro.build/environmental-impact/
Re:Docusaurus – Build optimized websites quickly, focus on y... by thibaultamartin on Thursday August 29, 2024 @05:32AM (#41388942)
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
Re:Docusaurus – Build optimized websites quickly, focus on y... by FireInsight on Thursday August 29, 2024 @05:55AM (#41389065)
The comparisons-page clearly highlights that Docusaurus is way heavier. https://starlight.astro.build/environmental-impact/#comparis...