slorber

9 ms·

1. 31.▲
   by slorber 4y ago

   Docusaurus maintainer here. I don't really understand what you mean, considering we don't have official support for API documentation, but have a plugin system allowing you to build your own support. And we have a few OpenAPI plug
2. 32.▲
   by slorber 4y ago

   Thanks, I wasn't alone in this project started internally at Meta a few years ago ;)
3. 33.▲
   by slorber 4y ago

   Hey, I'm the maintainer of Docusaurus For what it's worth, I'd really like to build a Second Brain, Obsidian, Digital Garden, Zettelkasten plugin, at least for myself. We have the infra to make it possible as a plugin, and yo
4. 34.▲
   by slorber 4y ago

   You mean Openapi? Docusaurus has at least 2 community openapi plugins + 1 Redoc community plugin + it's possible to build something custom with MDX,see Courier doc: https://www.courier.com/blog/how-we-built-our-doc
5. 35.▲
   by slorber 4y ago

   Not sure to understand what you mean here, can you explain? Docusaurus is a static site generator, a bit similar to Gatsby. It's opinionated toward docs/blog/pages but you can also use it in a more generic way.
6. 36.▲
   by slorber 4y ago

   Great! Let me know if you have any question
7. 37.▲
   by slorber 4y ago

   Thanks from the Docusaurus team ;)
8. 38.▲
   Rewriting tests from Cypress to Playwright using GPT3(contra.com)

   3 points by slorber 4y ago|0 comments
9. 39.▲
   by slorber 4y ago

   great one ;)
10. 40.▲
    UseSyncExternalStore() – The Underrated React API(thisweekinreact.com)

    1 points by slorber 4y ago|0 comments
11. 41.▲
    by slorber 4y ago

    Hey! great to know you like Docusaurus I'm the maintainer and we have a #jobs channel on discord where you'll find some offers. There's definitively a need for Docusaurus developers because technical writers are often not eno
12. 42.▲
    by slorber 4y ago

    For React developers: https://thisweekinreact.com/subscribe
13. 43.▲
    by slorber 4y ago

    Same https://twitter.com/sebastienlorber/status/15597974267263098...
14. 44.▲
    by slorber 4y ago

    Docusaurus is similar: you don't need to code anything, and can start with a config file + a folder of Markdown files. The only difference is that our config file is a .js file instead of .yaml, which I'd say is more powerful sinc
15. 45.▲
    by slorber 4y ago

    > I like include asciidoctor[1] and mdbook [2]. Though I find that even those are overkill for my hobby projects at least ... That's one thing: Docusaurus is not necessary just for hobby projects where the doc only exists for yourse
16. 46.▲
    by slorber 4y ago

    Well, we don't have at all the same definition of what "offensive" means then. > where a user says that it is just too much for her use case That's not at all what the op said, just a 2nd reminder: > > this is s
17. 47.▲
    by slorber 4y ago

    That is extremely easy to deploy Docusaurus on Vercel/Netlify. Here's a 70sec demo video deploying Docusaurus on Vercel: https://twitter.com/leeerob/status/1554211061284364290 We provide a "docusaur
18. 48.▲
    by slorber 4y ago

    thanks :) glad I was able to convince you to give it a try
19. 49.▲
    by slorber 4y ago

    What makes MkDocs easier to use than Docusaurus for a non-dev user exactly? The only thing I can see is that maybe you are more familiar with Python than Node.js? Otherwise using Docusaurus or MkDocs are both equally easy IMHO You can get a
20. 50.▲
    by slorber 4y ago

    We do support math equations, using KaTeX (apparently it is much faster than MathJax) https://docusaurus.io/docs/markdown-features/math-equations
21. 51.▲
    by slorber 4y ago

    My comments are all authentic and nobody at Meta proofread anything. I'm not even a Meta employee myself, just an external contractor working on Docusaurus.
22. 52.▲
    by slorber 4y ago

    100% agree, if you are familiar with Python, just try MkDocs first and see if it works for you.
23. 53.▲
    by slorber 4y ago

    Thanks :) that's more fair, but I admit it's still too much, and we are definitively looking forward to improve the amount of JS needed in the future! Some new features in React 18 (and upcoming releases) like Server Components ar
24. 54.▲
    by slorber 4y ago

    FYI Lee Robinson/Vercel just did a nice video demo of Docusaurus. https://twitter.com/leeerob/status/1554211061284364290 1 minute: it's what it takes to init a new Docusaurus site and publish it to a pro
25. 55.▲
    by slorber 4y ago

    Thanks! It's a bit hacky and will likely change in the future, but you can do so this way: https://docusaurus.io/docs/markdown-features/react#importing...
26. 56.▲
    by slorber 4y ago

    The downsides of a SPA is that using React client-side is more heavy than plan static html files with vanilla JS. It has a cost on the amount of JS to initially download, and executing that JS. We believe React enables a better UX, and this
27. 57.▲
    by slorber 4y ago

    Sorry to disappoint but Docusaurus does not provide that out of the box, however some devs built that as community plugins, but can't tell how qualitative it is. We believe a documentation can be much better when it's made interac
28. 58.▲
    by slorber 4y ago

    > Unless you're spinning up a documentation team with engineering resources, you probably want Docusaurus! > Rachel Nabors, Former ReactJS & React-Native docs manager > https://twitter.com/rachelnabors&#x2F
29. 59.▲
    by slorber 4y ago

    brabel that's fair, I also like simple things btw. Can you please share your doc site, so that I can at least know what kind of docs experience you are building? Tailwind is not something we support atm, and when we'll do it will
30. 60.▲
    by slorber 4y ago

    We build a single page application and use Webpack (nodejs build tool to create SPAs). In 2018 there weren't many alternatives to Webpack so we pick that, but may reconsider in the future. We don't have the bandwidth to create our