slorber

12 ms·

91.
by slorber 4y ago
If you can find a way to generate md files from YUIDoc, then Docusaurus could consume those MD files. We have seen many examples of Docusaurus sites generating pages from code comments, GraphQL or OpenAPI schemas For example here's a p
92.
by slorber 4y ago
IMHO Rust is useful for its speed. Many frontend tools use Rust today (like swc, napi-rs...). We are willing to include Rust in Docusaurus in the future (alongside Node.js), as it can help to build the static doc site faster. BTW our docusa
93.
by slorber 4y ago
This is not really comparable to Docusaurus: your thing is a little toy to publish documentation online but not really useful to create a great advanced and looking doc site. Just consider this: your tool requires client-side JS to work. Th
94.
by slorber 4y ago
Yes, and that's exactly the value proposition of Docusaurus. You just write markdown files. Eventually you create a custom landing page with React (optional, we also support a Markdown landing page). If you want to customize your site
95.
by slorber 4y ago
Thanks for the feedback Agree Docusaurus might be overkill for simple docs, however we also made sure the experience for simple usage is great. It comes with file-system routing convention, versioning, accessibility, internationalization, g
96.
by slorber 4y ago
What does it solve that Docusaurus does not solve? With MDX you can embed JS and/or React in Markdown already
97.
by slorber 4y ago
Docusaurus has a PWA plugin with offline support https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-pw... We'll look into more "offline supports" in the future including producing p
98.
by slorber 4y ago
With Docusaurus we are looking to compete with top notch documentations, not simple ones. The goal is not only to get some html files online but also to great a first-class experience for the end user. Do you truly believe that your home-ma
99.
by slorber 4y ago
Hey, Docusaurus even works in your browser docusaurus.new I'm not sure why you went through all this pain, but if you don't report it, how can we fix it? Others do not have the same experience afaik.
100.
by slorber 4y ago
As the Docusaurus site maintainer, I believe MkDocs is great (and probably simpler) but our plugin system is more powerful, MDX/React makes it easier to make the docs interactive, and we have more flexibility for theming. See the carou
101.
by slorber 4y ago
Why wouldn't you want to run JS outside of a browser? That looks like rejecting Node.js for Python. I also think MkDocs is great (and I'm the Docusaurus maintainer), and probably even simpler, but IMHO Docusaurus is more flexible
102.
by slorber 4y ago
Hey there! I am the current Docusaurus lead maintainer, if you have any question let me know. You don't need to be Stripe and have a full engineering team working on your doc to make it awesome. Docusaurus is a content-centric static s
103.
Docusaurus 2.0(docusaurus.io)
202 points by slorber 4y ago|140 comments
104.
by slorber 4y ago
I read the whole article, and I found it quite interesting and it has a lot of good references that I've encountered in the past (for example Zombie Children etc...) However I find it very difficult to read: there's so much text a
105.
Airbnb’s CSS Trip: from Sass to Linaria (no-runtime CSS-in-JS lib)(medium.com)
2 points by slorber 4y ago|0 comments
106.
by slorber 4y ago
I don't know about Markdoc but with Docusaurus you can have your blog in 1min, just go to docusaurus.new (I'm the maintainer)
107.
Building a JavaScript Bundler(cpojer.net)
51 points by slorber 4y ago|8 comments
108.
by slorber 4y ago
Docusaurus maintainer here Yes we like MDX and live code blocks to embed natively runnable code in your page. I don't like the idea of loading a remote iframe much (at least for most cases using JS). The StackBlitz / WebContainer
109.
by slorber 5y ago
Docusaurus maintainer here The Docusaurus tabs use MDX, it's not a custom syntax for tabs, it's a powerful low-level way to use React or frontend interactive components in markdown, and likely to become more and more widespread (
110.
by slorber 5y ago
Totally disagree on that. They are static site generators, and for many content sites like blogs etc, most features (linking etc) will work even if React does not load/hydrate, like a traditional SSG. Navigation does not 100% need to b
111.
by slorber 5y ago
I'm the maintainer The project is mostly sponsored by Meta/Facebook because the company need such a tool for internal/external docs However it's still useful to have external sponsors to get more bandwidth and also to be
112.
by slorber 5y ago
RN views can already be SSRed for a while now. The problem has never been SSR but the divergent navigation patterns/state between web and mobile, for which it's not easy to build a shared abstraction. Looks like you feel clickbai
113.
by slorber 5y ago
I'm the Docusaurus maintainer, let me know if you have questions I think Docusaurus looks like a good fit for you. If your project is very large, we are not the fastest SSG on terms on build times and definitively want to improve with
114.
Shopify explains how/why they built a React framework(shopify.engineering)
12 points by slorber 5y ago|0 comments
115.
Shopify Hydrogen: Developer Preview(shopify.com)
1 points by slorber 5y ago|0 comments
116.
Jamstack: Each static host serve HTML files differently(github.com)
2 points by slorber 5y ago|0 comments
117.
by slorber 5y ago
not new, we have many sites that are just using the blog, or just using the docs. Example of just using the blog: https://blog.johnnyreilly.com/ https://blog.developersam.com/
118.
by slorber 5y ago
not sure to understand, any concrete use-case to share? Docusaurus is a SSG, does not need a server in production and it's not a goal. If something happens live, then it can only happen on your dev computer
119.
by slorber 5y ago
We use MDX which basically compiles markdown to React components and allows to interleave components inside md content. So you can do similar things like having one doc importing the other. Maybe not as flexible (like importing only a few l
120.
by slorber 5y ago
You can embed doc generated by other tools in a Docusaurus site, as a plain page or an iframe. Some people embed Javadoc, OpenAPI or Redoc in Docusaurus. You can also generate md to make that doc native. I've seen people generating doc

More ›