Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Migrate ReactNative website to Docusaurus v2 #3195

Closed
slorber opened this issue Aug 3, 2020 · 3 comments
Closed

Migrate ReactNative website to Docusaurus v2 #3195

slorber opened this issue Aug 3, 2020 · 3 comments
Labels
mlh Major League Hacking Fellowship proposal This issue is a proposal, usually non-trivial change

Comments

@slorber
Copy link
Collaborator

slorber commented Aug 3, 2020

💥 Proposal

Migrate the ReactNative website (repo) to Docusaurus v2.

This site is a complex versioned site, but has no i18n, so we can normally migrate it today.

It is a good test to try the new migration cli, and see if Docusaurus v2 has good enough feature parity with v1.

I'd like the Major League Hacking community folks to work on this migration.


Rachel Nabors (@rachelnabors) and Bartosz Kaszubowski (@Simek here and on Discord) are helping to maintain the v1 site.

Some important things to consider:

  • v1 has many (too much) versions, and a long build time in the CI (30-90min). We don't need to support all these versions, we can only keep versions from 0.60 and "archive" older versions as a standalone v1 site
  • there's a requirement to generate all the missing pages, for all the versions (???)
  • custom Prism setup and SnackPlayer (see remarkable plugins)
  • custom JS files here
  • static files to redirects moved/renamed docs (here) => should be easy to handle with the client side redirect plugin.

The ReactNative docs are actively edited, so for this migration, we should not focus our initial efforts on fixing the content related issues (md -> MDX), but rather try to focus our efforts on the infrastructure, and handle the changes on the content/docs only once the rest is handled.

@slorber slorber added proposal This issue is a proposal, usually non-trivial change mlh Major League Hacking Fellowship labels Aug 3, 2020
@teikjun
Copy link
Contributor

teikjun commented Aug 4, 2020

I'll work on this :)
@darshkpatel is interested to help too!

@slorber
Copy link
Collaborator Author

slorber commented Aug 5, 2020

thanks :) can you open a draft/PR/branch asap so that we can link to it and track/review progress?

@teikjun
Copy link
Contributor

teikjun commented Aug 7, 2020

We're keeping track of the migration here: MLH-Fellowship/react-native-website#37

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
mlh Major League Hacking Fellowship proposal This issue is a proposal, usually non-trivial change
Projects
None yet
Development

No branches or pull requests

2 participants