From e2330f6f950173c47c1294c36f757d7f849cdd23 Mon Sep 17 00:00:00 2001
From: Jinge Li <9894243+chinapandaman@users.noreply.github.com>
Date: Mon, 27 May 2024 22:45:04 +0000
Subject: [PATCH] PPF-625: update infos about Adobe Acrobat

---
 docs/simple_fill.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/simple_fill.md b/docs/simple_fill.md
index 14a178e3..0a329d2b 100644
--- a/docs/simple_fill.md
+++ b/docs/simple_fill.md
@@ -30,3 +30,11 @@ with open("output.pdf", "wb+") as output:
 
 The optional parameter `flatten` has a default value of `False`, meaning PDF forms filled using `FormWrapper` will by 
 default remain editable. Setting it to `True` will flatten the PDF after it's filled, making all widgets read only.
+
+**NOTE:** Currently there are some known issues with Adobe Acrobat displaying PDF forms filled using this method. 
+Specifically the text content that gets filled into a text field widget will only appear when the text field is clicked 
+and selected. This is not an issue in browsers like Chrome or other PDF viewing apps like Document Viewer 
+(the default PDF app on Ubuntu). It is not 100% clear why such behavior exists for Adobe Acrobat but the speculated reason 
+is that Adobe Acrobat seems to require way more complex metadata than browsers like Chrome for a text field widget to be 
+rendered properly. If you have to use Adobe Acrobat, consider using `PdfWrapper` instead to fill your PDF forms as this is 
+not something that can be fixed right now.