If you're looking for a new docs framework for your dev tool, I can't recommend Docusaurus enough. 1. You can change the appearance of any component—no matter how big or small—by ejecting its raw React code into your source tree. I've ejected almost all of its major components and restyled them with Tailwind. 2. It supports content written with MDX, which is like Markdown but better. MDX lets you write JSX tags so you can render React components (like badges and banners) directly inline your content. No more messy templating. 3. It bundles Prism for code snippet highlighting. So you if you want to change how each and every token of your language gets styled—which I do—you can override it with a simple centralized map—which I have. 4. You can swap out its on-site search engine with Algolia, now widely considered the best option for developer sites. It is, in other words, the perfect tool for people like me who are obsessed with every pixel.
Alexey Zimarev
7mo
I moved from Docusaurus to Astro and Starlight
Dmitriy Rotaenko
7mo
Hi, looks cool and unrecognizable comparing to standard infima styling. How did you manage to change sidebar appearance like that? Is it open source? If not can you please share a clue?
Manveer Chawla
7mo
How does it compare with Mintlify’s of the world?
Tony Kau
7mo
I’m newer to docusaurus but so far it’s a great package!
Chuck Martin
7mo
The “framework,” or any tool, is irrelevant if the person using that framework cannot write clearly, consistently, concisely, and accurately, and then successfully manage all that content for the many channels that content is consumed in. IOW, writing skills & content management skills > tools & frameworks.
Chris Zheng
7mo
Also the Swagger addon.
If you want to go one step further, try using https://codehike.org/ on top of docusaurus. For sites that embed lots of code, like docs and tutorials, it can be a game changer.