From 8597e5dcdb62af7d9e8b6ccd503ab2cf2e7075a0 Mon Sep 17 00:00:00 2001 From: Cole Cecil Date: Wed, 24 Jan 2024 05:12:06 -0600 Subject: [PATCH] docs: update troubleshooting details for v3 migration (#9782) --- website/docs/migration/v3.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/website/docs/migration/v3.mdx b/website/docs/migration/v3.mdx index 446a60ab3d..cf428ba010 100644 --- a/website/docs/migration/v3.mdx +++ b/website/docs/migration/v3.mdx @@ -980,12 +980,12 @@ This syntax is now invalid MDX, and would require to escape the `{` character: ` We recommend to keep this compatibility option on for now, until we provide a new syntax compatible with newer versions of MDX. -## Ask For Help +## Troubleshooting In case of any upgrade problem, the first things to try are: - make sure all your docs compile in the [MDX playground](https://mdxjs.com/playground/), or using [`npx docusaurus-mdx-checker`](https://github.com/slorber/docusaurus-mdx-checker) -- delete `node_modules` and run `npm install` again +- delete `node_modules` and `package-lock.json`, and then run `npm install` again - run `docusaurus clear` to clear the caches - remove third-party plugins that might not support Docusaurus v3 - delete all your swizzled components