From eeb5b7796493b3eccc16d2306c115f51fa4c9c17 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 3 Sep 2026 01:27:47 +0000
Subject: [PATCH 1/2] Updated mintlify pages

- Updated cli/commands.mdx

Mintlify-Source: dashboard-editor
---
 cli/commands.mdx | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)

diff --git a/cli/commands.mdx b/cli/commands.mdx
index c2f5d3f165..8637ab75a6 100644
--- a/cli/commands.mdx
+++ b/cli/commands.mdx
@@ -2,7 +2,12 @@
 title: "Mintlify CLI command reference"
 sidebarTitle: "Commands"
 description: "Complete reference for Mintlify CLI commands and flags, including mint index, mint dev, mint validate, mint broken-links, and more."
-keywords: ["CLI", "mint", "commands", "flags", "reference"]
+keywords:
+  - "CLI"
+  - "mint"
+  - "commands"
+  - "flags"
+  - "reference"
 boost: 3
 ---
 
@@ -642,7 +647,7 @@ mint format
 Run the command from the root of your docs project. It walks every subdirectory, skipping paths matched by `.gitignore` and any Mintlify ignore rules. Files that already match the canonical output are left untouched.
 
 <Warning>
-  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.
+  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.<br /><br />Due to potentially large diffs, first resolve all important pending branches. 
 </Warning>
 
 When it finishes, the command prints how many MDX files were reformatted and how many failed to parse. If any file fails, the command exits with code `1` and prints the file path and error, so you can run it in CI to enforce consistent formatting.

From e568672f4619551b9641b145cb1c185d97c08ed8 Mon Sep 17 00:00:00 2001
From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com>
Date: Thu, 3 Sep 2026 01:28:12 +0000
Subject: [PATCH 2/2] Updated mintlify pages

- Updated cli/commands.mdx

Mintlify-Source: dashboard-editor
---
 cli/commands.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cli/commands.mdx b/cli/commands.mdx
index 8637ab75a6..97322deaa3 100644
--- a/cli/commands.mdx
+++ b/cli/commands.mdx
@@ -647,7 +647,7 @@ mint format
 Run the command from the root of your docs project. It walks every subdirectory, skipping paths matched by `.gitignore` and any Mintlify ignore rules. Files that already match the canonical output are left untouched.
 
 <Warning>
-  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.<br /><br />Due to potentially large diffs, first resolve all important pending branches. 
+  `mint format` rewrites files in place. Commit or stash your changes before running it so you can review the diff.<br /><br />Due to potentially large diffs, first resolve all important pending branches. Then create a new branch before running `mint format`.
 </Warning>
 
 When it finishes, the command prints how many MDX files were reformatted and how many failed to parse. If any file fails, the command exits with code `1` and prints the file path and error, so you can run it in CI to enforce consistent formatting.