add upgrading steps

Author: ethanpalm

settings.mdx

@@ -1396,3 +1396,50 @@ See [Themes](themes) for more information.
     ```
   </Tab>
 </Tabs>
+
+## Upgrading from `mint.json`
+
+If your docs project uses the deprecated `mint.json` file, follow these steps to upgrade to `docs.json`.
+
+<Steps>
+<Step title="Install or update the CLI">
+If you haven't installed the [CLI](/installation), install it now:
+
+<CodeGroup>
+
+```bash npm
+npm i -g mint
+```
+
+
+```bash yarn
+yarn global add mint
+```
+
+
+```bash pnpm
+pnpm add -g mint
+```
+
+</CodeGroup>
+
+If you already have the CLI installed, make sure it is up to date:
+
+```bash
+mint update
+```
+
+</Step>
+<Step title="Create your docs.json file">
+In your docs repository, run:
+
+```bash
+mint upgrade
+```
+
+This command will create a `docs.json` file from your existing `mint.json`. Review the generated file to ensure all settings are correct.
+</Step>
+<Step title="Delete your mint.json file">
+After verifying your `docs.json` is configured properly, you can safely delete your old `mint.json` file.
+</Step>
+</Steps>