From be65dc8acca2e03283f93f4a9e602b528209fe66 Mon Sep 17 00:00:00 2001
From: Gustavo Madeira Santana <gumadeiras@gmail.com>
Date: Mon, 2 Mar 2026 11:34:06 -0500
Subject: [PATCH] docs(diffs): clarify file size limitations

---
 docs/tools/diffs.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/tools/diffs.md b/docs/tools/diffs.md
index 669470005dd..323374ac5a5 100644
--- a/docs/tools/diffs.md
+++ b/docs/tools/diffs.md
@@ -105,6 +105,11 @@ Validation and limits:
 - `title` max 1024 bytes.
 - Patch complexity cap: max 128 files and 120000 total lines.
 - `patch` and `before` or `after` together are rejected.
+- Rendered file safety limits (apply to PNG and PDF):
+  - `fileQuality: "standard"`: max 8 MP (8,000,000 rendered pixels).
+  - `fileQuality: "hq"`: max 14 MP (14,000,000 rendered pixels).
+  - `fileQuality: "print"`: max 24 MP (24,000,000 rendered pixels).
+  - PDF also has a max of 50 pages.
 
 ## Output details contract