-
Notifications
You must be signed in to change notification settings - Fork 4.4k
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 Website to Docusaurus 2 #2146
Comments
Awesome !! |
@darshkpatel I think that you should focus on the content and functionality (ex. SnackPlayer, Prism config, content tabs, non versioned pages, manual redirects for removed pages etc.), due to restricted time of MLH project. Fine tuning design, adding back custom design tweaks (like platform labels) and correcting typography might be a lengthy process. Generally I would like to see the Dark Mode, but I have not discuss about this with @rachelnabors yet. P.S. I'm experiencing issue with the disappearing content (after a while) on the page linked in the first post. Is it a known issue? P.S.2 The second (and biggest problem in my eyes) is that currently doc files migration destroyed the GIT changes history (files were removed and than added back instead of moving them within the repository - using |
Please implement the theme switcher—we can handle the design tweaks necessary to make it work. But focus on the functionality: inline toggles for examples and notes. It would be best if we could keep the contribution records with Thank you! |
Thanks for pointing it out! Weren't aware of it since it doesn't occur while running the dev server. Will add to ToDo |
That looks quite nice already! Also see the content disappear, that's what I reported you @rachelnabors , this seems to be related to React hydration as it only happens on first page load, not navigation => https://react-native-v2.netlify.app/docs/ I also think having the theme switcher is great and it seems to work quite nicely already. Looks like the code blocks highlighting does not work, but I suspect this is because we don't integrate properly the embedded Snack player iframe. About git, you are totally right, and I was pretty sure this would be a problem for many large v1 website like this one. The migration cli we made is a first version, there are still many things that can be improved, but preserving git history is probably the most critical one. facebook/docusaurus#3103 I also think that for now we should try to see how to add the missing features like the Snack Player etc. Once these are done, we'd have a better idea of how hard it will be to complete this migration project. |
Can be closed in favor in the new migration fork: react-native-website-migration#7 |
Description
Hi there! The Docusaurus team is currently developing Docusaurus 2, which now has feature parity with React Native's current usage of Docusaurus.
Docusaurus 2 brings about many improvements:
@darshkpatel and I will be helping to migrate and be the POC throughout the migration process.
You can view the test site here: https://reactnative-v2.netlify.app/docs/
We're keeping track of our progress in #2139.
To do list
class
toclassName
, changestyle="..."
tostyle={{...}}
.'pages/en'
/docs/assets
into/static/docs/assets
/blog/assets
into/static/blog/assets
Legends:
🔨 - in progress
Note: We'll add a more detailed log of changes after completing each item
The text was updated successfully, but these errors were encountered: