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...
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