Upgrade to docusaurus 2

[endiliey]

Motivation

Hello there, as discussed in #6793 we would like to dogfood docusaurus v2 for CRA. The development experience for v2 is much better because client side rendering is also enabled. The website is also seems to be very performant (its a single page app now but also staticly rendered for SEO)

It's better to test it from netlify preview https://deploy-preview-7785--create-react-app.netlify.com/

Probably what's missing is the "Edit" button on each docs page and a collapsible sidebar. That will come in .alpha.26 instead

Preview

cc @yangshun

[yangshun]

Wow this is awesome. It's nice that there were so few Docusaurus changes to be made. I'm not sure if the CRA maintainers would want to separate out the Markdown changes vs the Docusaurus changes. Might be cleaner, but this looks fine to me.

Approved from the Docusaurus side!

cc @amyrlam here's our long overdue PR 😅

[amyrlam]

hey @yangshun@endiliey! nice to see you on github again, docusaurus 2 is looking 💅

looks great to me, will let @iansu do the official approval

[iansu]

@yangshun this looks great! Are there any known limitations or bugs other than the two that you mentioned? Do you think this is ready to replace our current docs?

[yangshun]

We're working on the missing docs features (in fact we have them built in facebook/docusaurus#1817 and facebook/docusaurus#1818)! We'll release a new version very soon and help you guys upgrade then.

Other than that, maybe the CSS will not render well in IE11 due to usage of CSS variables (but we intend to fix it in future). But that's about it!

[endiliey]

Updated. Check https://deploy-preview-7785--create-react-app.netlify.com/docs/getting-started/

[yangshun]

@iansu for your review. There's feature parity with V1 now. Thank you!

[iansu]

Looks great! Thanks!

[endiliey]

@iansu

ping me and @yangshun when there is an issue with the website. That's the purpose of our dogfooding. You can also try to look into looking for contributors to revamp the landing page to be nicer as well since the site is a SPA now.

[iansu]

@endiliey Will do! Thanks again.