removed mint.json vs docs.json file (#527)

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Update overview.mdx

changed numbering (buggy in web editor)

* fix broken links

* delete broken link

* delete unneeded changes

---------

Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
Co-authored-by: tiffany-mintlify <[email protected]>
Co-authored-by: Hahnbee Lee <[email protected]>

Author: 3 people

changelog/overview.mdx

@@ -5,20 +5,36 @@ mode: "center"
 ---
 
 <Update label="February 2025">
-  ## .md support for LLMs
+  ## New Configuration Schema `docs.json`
+
+  We've introduced a new `docs.json` schema as a replacement for `mint.json`, to support better multi-level versioning, easier visual comprehension, and more consistent terminology. For more information on what's changed, [check out our blog](https://mintlify.com/blog/refactoring-mint-json-into-docs-json).&#x20;
 
-  All documentation pages are now automatically available as plain Markdown files—just append `.md` to the URL. This makes it easier for LLMs to ingest individual pages from your documentation.
 
-  ## docs.json replacing mint.json
 
-  Upgrades include better multi-level versioning, easier visual comprehension, and more consistent terminology.
+  Upgrade from `mint.json` to `docs.json` with the following steps:
 
-  [Update your Mintlify CLI](/navigation/config-upgrade#upgrading-from-mint-json-to-docs-json).
+  1. Make sure your CLI is the latest version
+
+  ```
+  npm i mintlify@latest -g
+  ```
+
+  2. In your docs repository, run
+
+  ```
+  mintlify upgrade
+  ```
+
+  3. Delete your old mint.json file and push your changes
 
   ## CI Checks
 
   Automatically lint your docs to find broken links, discover spelling and grammar issues, or enforce writing styles with your own Vale config. Learn more in our [docs](settings/ci).
 
+  ## .md support for LLMs
+
+  All documentation pages are now automatically available as plain Markdown files—just append `.md` to the URL. This makes it easier for LLMs to ingest individual pages from your documentation.
+
   ## More Themes
 
   New pre-built themes to modify the look & feel of your docs. Configure via your [docs.json file](/settings/global).
@@ -321,8 +337,6 @@ mode: "center"
 
   * [Read the blog announcement](https://mintlify.com/blog/widget)
 
-  * [Learn how to install the Widget](/advanced/rest-api/overview)
-
   ## Pro Plan
 
   We also updated our pricing plans for better customizability and scale.
@@ -407,4 +421,4 @@ mode: "center"
   * Open-source MDX Engine: We've exposed two APIs—getCompiledMdx and MDXComponent—so you can access Mintlify markdown and code syntax highlighting. [Contributions to the project](https://github.com/mintlify/mdx) are welcome.
 
   * AI Chat Insights: Segment chat history by date and increase AI Chat quota from the dashboard, and see how often a specific query appears.
-</Update>
+</Update>

code.mdx

@@ -8,12 +8,14 @@ icon: 'code'
 
 ### Inline Code
 
-To denote a `word` or `phrase` as code, enclose it in backticks (`).
+To denote a `word` or `phrase` as code, enclose it in backticks (\`).
 
 ```
 To denote a `word` or `phrase` as code, enclose it in backticks (`).
 ```
 
+
+
 ### Code Block
 
 Use [fenced code blocks](https://www.markdownguide.org/extended-syntax/#fenced-code-blocks) by enclosing code in three backticks and follow the leading ticks with the programming language of your snippet to get syntax highlighting. Optionally, you can also write the name of your code after the programming language.
@@ -36,4 +38,4 @@ class HelloWorld {
 ```
 ````
 
-Visit the [Code Block page](/content/components/code) for more detailed docs.
+Visit the [Code Block page](/content/components/code) for more detailed docs.

content/components/cards.mdx

@@ -10,21 +10,21 @@ icon: "rectangle"
 </Card>
 
 <RequestExample>
+  ```jsx Card Example
+  <Card title="Click on me" icon="link" href="/content/components/card-group">
+    This is how you use a card with an icon and a link. Clicking on this card
+    brings you to the Card Group page.
+  </Card>
+  ```
+
+  ```jsx Image Card Example
+  <Card title="Image Card" img="/images/card-with-image.png">
+    Here is an example of a card with an image
+  </Card>
+  ```
+</RequestExample>
 
-```jsx Card Example
-<Card title="Click on me" icon="link" href="/content/components/card-group">
-  This is how you use a card with an icon and a link. Clicking on this card
-  brings you to the Card Group page.
-</Card>
-```
 
-```jsx Image Card Example
-<Card title="Image Card" img="/images/card-with-image.png">
-  Here is an example of a card with an image
-</Card>
-```
-
-</RequestExample>
 
 ### Horizontal Card
 
@@ -70,4 +70,4 @@ Add an `img` property to a card to display an image on the top of the card.
 
 <ResponseField name="img" type="string">
   The url or local path to an image to display on the top of the card
-</ResponseField>
+</ResponseField>

docs.json

@@ -33,8 +33,7 @@
                   "navigation/pages",
                   "navigation/divisions",
                   "navigation/versions",
-                  "navigation/localization",
-                  "navigation/config-upgrade"
+                  "navigation/localization"
                 ]
               },
               "migration"