Dogfooding Docusaurus 2

[yangshun]

Is this a bug report?

No

Hi there! Docusaurus team here! We're currently developing Docusaurus 2 and are almost done with an MVP that doesn't include translations and versioning features, which means there's feature parity with CRA's current usage of Docusaurus. We'd like to dogfood v2 on CRA mainly to try out the migration process with existing v1 sites.

Docusaurus 2 brings about many improvements:

• Client-side rendering with prerendering (site works without JavaScript!)
• More flexible appearance - Customizable layouts, CSS modules, etc
• Embeddable interactive React components within markdown via MDX

Downsides:

• Documentation for v2 isn't quite ready yet, but given that CRA is not using too many features of Docusaurus, that's probably ok.
• We use CSS variables in v2 and hence IE11 isn't supported. We plan to support a way to build an IE11 compatible version which replaces CSS variables entirely with its values, but it won't be arriving that soon. Update 4/16/19: This is done.

Would the CRA team be open to dogfooding v2? We would do the initial migration and help out with any issues that arise. There aren't too many breaking changes. If you all are agreeable, we plan to kick off the process in May. Let me know what you guys think!

cc @endiliey @JoelMarcey

[amyrlam]

I think this sounds like a good idea and I can help. Could probably do most of it on a separate branch?

I can bring it up at the CRA meeting next week and report back...

[yangshun]

Thanks @amyrlam! Keep me posted! 😄

[iansu]

I'm on board with this. I agree that it would be nice to do this on a branch so we can test the new version out. Once v3 matches the current functionality we use we can roll it out.

[yangshun]

We've launched the new CRA site with Docusaurus 2, closing this!