diff --git a/editor/review.mdx b/editor/review.mdx
index 9ee81ad74..72d504020 100644
--- a/editor/review.mdx
+++ b/editor/review.mdx
@@ -176,7 +176,9 @@ If Mintlify hosts your repository and approvals aren't required, the publish men
 
 Click any changed file in the publish menu to open it in diff view against the published version. To leave diff view, click **Viewing changes** in the top bar. Visual mode shows a visual diff and source mode shows a text diff. Files that can't display a diff, such as images or deleted files, appear in the list but aren't clickable.
 
-In a source mode diff of a page, choose **Unified** or **Split** in the top bar to show changes in one column or side by side. Until you choose, the editor picks the layout that fits your window width. The editor remembers your choice for later diffs.
+To compare `docs.json` with the version on the branch your changes publish to, open `docs.json` in source mode and click **Show changes** in the top bar. The editor shows a read-only text diff. Click **Hide changes** to go back to editing.
+
+In a source mode diff of a page or `docs.json`, choose **Unified** or **Split** in the top bar to show changes in one column or side by side. Until you choose, the editor picks the layout that fits your window width. The editor remembers your choice for later diffs.
 
 You can open [hidden pages](/organize/hidden-pages) that appear in the branch diff from the publish menu, even though they don't appear in your site navigation.