[WIP] Upgrade Docusaurus to v3.7.0 #6851
Conversation
|
The latest updates on your projects. Learn more about Vercel for Git ↗︎
|
github-actions
bot
added
the
size: large
There was a problem hiding this comment.
This is currently redirected, so opted to delete rather than update to support it in the new Docusaurus version.
| @@ -270,7 +268,6 @@ var siteSettings = { | |||
| ], | |||
| plugins: [ | |||
| [path.resolve("plugins/insertMetaTags"), { metatags }], | |||
| path.resolve("plugins/svg"), | |||
There was a problem hiding this comment.
This custom svg plugin was created during the initial Docusaurus setup. It didn't feel necessary, and svgs still appear to work after removing this plugin.
|
Re: the @john-rock feel free to hold off on the review for this for now. |
|
@john-rock Okay I gave up on trying to make the |
|
You give up fast 😅 If you can't upgrade to v4 due to the documented breaking changes, v3 is also compatible and works:
Your site now bundles in 15s instead of 60s |
@slorber I was doing my best to avoid the potential rabbit hole of getting stuck on this another day 😅
That did it. The That latest deploy was the fastest we've ever had for our Docs site. Again, thank you for your help with this and following up here with that suggestion! |
package.json
Outdated
| @@ -0,0 +1 @@ | |||
| {} | |||
What are you changing in this pull request and why?
This upgrades Docusaurus to v3.7.0. The primary goal for the upgrade is to access new Docusaurus Faster features, which will hopefully improve the build times, and reduce the bundle sizes.
Preview
Click through the site and verify pages working correctly:
Notes
I was unable to get the
rspackBundlerworking due to us using the@stoplight/elementspackage in our api pages. Rspack replaces Webpack for bundling the site, but we have a custom webpack config plugin which sets a Node polyfill to allow this package to work.This webpack config is supposed to continue to work when using the Rspack bundler, but i haven't been able to figure it out. Will save that to try again on a rainy day... When it comes time to try enabling
rspackBundleragain, we can follow these steps:rspackBundler: truein docusaurus.config.jsnode-polyfill-webpack-pluginto latest version (or at least >= v3)/dbt-cloud/api-v2and/dbt-cloud/api-v3pages.More deets in this Git thread.