slorber

10 ms·

1. 61.▲
   by slorber 4y ago

   I'm not belittling all other tools, just MdWiki (and Docsify that I consider in the same category of client-side JS, hash-based docs tool). All the other docs tools are great too, and I'm not saying Docusaurus is better. I believe
2. 62.▲
   by slorber 4y ago

   We have a default tabs component that you can use with MDX https://docusaurus.io/docs/markdown-features/tabs But really, MDX gives you the freedom to implement your own tabs system. See for example how Courier is
3. 63.▲
   by slorber 4y ago

   We optimize for features, easy of customization and easy of upgrades in priority Now we have large docs sites with thousands of pages, and it's painful if their static site takes forever to build, so we should also optimize for speed.
4. 64.▲
   by slorber 4y ago

   We see many GitBook users migrating to Docusaurus and being satisfied with Docusaurus features, flexibility, UX/UI and performance https://twitter.com/__morse/status/1532430153338474534 https://twi
5. 65.▲
   by slorber 4y ago

   Maybe the word "toy" is wrong and I'm sorry for that if it offended anymore But I stand by that such documentation tools are really not great. I've argued why here: https://news.ycombinator.com/item?id=32
6. 66.▲
   by slorber 4y ago

   Thanks a lot swyx ;)
7. 67.▲
   by slorber 4y ago

   Thanks for the feedback We call this "contextual search": https://docusaurus.io/docs/search#contextual-search It's now enabled by default and facet on version + language so normally you don't have t
8. 68.▲
   by slorber 4y ago

   Thanks for the feedback To be fair what you describe is more a side-result of our community rather than our own features. CMD+K is a popular shortcut. It's not built-in Algolia DocSearch modal. Also other frameworks like VitePress have
9. 69.▲
   by slorber 4y ago

   Well, the op was quite offensive in the first place > this is so incredibly over-engineered it's comical to me. Isn't it fair that I defend the tool I work on after reading such comment? The op can stick with its original tool
10. 70.▲
    by slorber 4y ago

    Thanks for the feedback Yes Docusaurus v2 is more featured and powerful than v1. I understand simplicity is an advantage and sometimes less feature is actually better. We aim for site owners that want to start simple, and yet scale their si
11. 71.▲
    by slorber 4y ago

    JimDabell I'm sorry if it feels so. I think I'm quite fair with other tools. I shouldn't have used the word "toy" but I mean it. I really dislike tools such as Docsify or MDWiki and can clearly back this up: those t
12. 72.▲
    by slorber 4y ago

    Thanks Lee ;)
13. 73.▲
    by slorber 4y ago

    I am not able to understand what you mean here sorry. What is the thing to optimize then?
14. 74.▲
    by slorber 4y ago

    Docusaurus wants to make the docs interactive to produce a great reading experience. How can we provide that and yet print on PDF? Remember Docusaurus input remains markdown files so you can still look for another tool that is able to gener
15. 75.▲
    by slorber 4y ago

    We do not have a first-class plugin to generate a linear PDF documentation, but are willing to have one. Our plugin lifecycles could enable you to build one, and we might create an official one in the future. Keep in mind Docusaurus is a go
16. 76.▲
    by slorber 4y ago

    Thanks saghul ;) glad you liked it. Yes our community is an important part in the success of Docusaurus
17. 77.▲
    by slorber 4y ago

    ahah, I welcome all comments, haters are a good source of engagement ;)
18. 78.▲
    by slorber 4y ago

    Thanks nindalf! Yes that's the value prop of Docusaurus: you can get started in 5 minutes, but the tool scales well with your usage if you need something more advanced
19. 79.▲
    by slorber 4y ago

    Can confirm that the React beta docs do not use Docusaurus, and it 100% makes sense to me. I've explained why here: https://twitter.com/sebastienlorber/status/14527225683902218... Note that we also want to ex
20. 80.▲
    by slorber 4y ago

    Docusaurus is very similar to VitePress, VuePress, MkDocs, Nextra, Dokz, Docus... all those tools allow you to focus on content. I believe we have much more features and more flexibility to customize your site in Docusaurus, but other tools
21. 81.▲
    by slorber 4y ago

    Sorry about that you are not the first to tell me I use too much bold. Will remember for next time
22. 82.▲
    by slorber 4y ago

    We don't integrate Docusaurus with such tools atm but you can build a Docusaurus plugin that would allow to integrate with such tools. Here's for example a plugin that integrates with TypeDoc (TS): https://www.npmjs.com
23. 83.▲
    by slorber 4y ago

    Hey, thanks for your feedback We are definitively interested to provide more themes in the future, starting with a TailwindCSS one. I also believe the Tailwind ecosystem provides a lot of useful copy/pastable code snippets (including f
24. 84.▲
    by slorber 4y ago

    Thanks for the feedback ;) The stable release is not very different from the latest betas: it's mostly our commitment to respect Semantic Versioning for the next releases.
25. 85.▲
    by slorber 4y ago

    Thanks a lot Johnny Just sharing your blog url for the interested: https://blog.johnnyreilly.com/ We also have a lot of other personal website/blogs in our site showcase: https://docusaurus.io/showcase?
26. 86.▲
    by slorber 4y ago

    You can restrict docs access by using Http basic auth at the host level (CDNs like Vercel/Netlify/Cloudflare usually provide this feature). If you want in-app authentication, remember we are a static site generator so at the end o
27. 87.▲
    by slorber 4y ago

    Even if you don't like Meta, is that a good reason to reject Docusaurus? It's not really related to the Facebook product in anyway, it's MIT, free, open-source, and does not have any tracking visitor/dev tracking.
28. 88.▲
    by slorber 4y ago

    Docusaurus has been quite inspired by Gatsby and Next.js. We simple removed the GraphQL data later from Docusaurus, and are more opinionated toward the docs use-case while Gatsby is a more generic tool focusing a lot on CMS integration. We
29. 89.▲
    by slorber 4y ago

    That's not really fair: that's because I included a lot of images in the blog post in carousel. I admit it's not great and I didn't have time to optimize deeply these custom image carousels for the launch to load hidden
30. 90.▲
    by slorber 4y ago

    Those are all in the carousel of our blog post, which include many more. Really tried hard to highlight the fact that you can truly customize your docs site with Docusaurus ;) custom navbar, footer, layout, sidebars... everything