From 5417d43e88864f16e2664d59102f60e6196ac597 Mon Sep 17 00:00:00 2001
From: MikhailB <36865467+lKolabrodl@users.noreply.github.com>
Date: Sun, 30 Aug 2026 05:30:25 +0300
Subject: [PATCH] docs: describe Edit PDF annotations and forms

---
 README.md  | 23 +++++++++++++++++++++++
 ROADMAP.md | 16 +++++++++++-----
 2 files changed, 34 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index e972bb9..4ec2b00 100644
--- a/README.md
+++ b/README.md
@@ -57,6 +57,29 @@ service in the middle.
 | Compare PDFs | | |
 | Remove blank pages | | |
 
+### Edit PDF capabilities
+
+The Edit PDF workspace adds text, images, shapes, links, and freehand drawing as
+new content. It can also create PDF notes, highlights, underlines, strikeouts,
+and ink annotations while preserving existing annotations.
+
+For interactive PDFs, OffPDF can fill existing AcroForm text fields (including
+multiline fields), checkboxes, radio buttons, combo boxes, and list boxes. Form
+fields stay interactive by default.
+
+The two flattening options have different scopes:
+
+- **Flatten form fields** turns supported form widgets into page content while
+  leaving other annotations interactive.
+- **Flatten annotations** turns all remaining annotations into non-interactive
+  page content. When a PDF contains form fields, OffPDF requires form fields to
+  be flattened as part of this operation.
+
+Current limits: XFA forms are not supported; only the first PDF's AcroForm can
+be filled when several files are combined; and Edit PDF does not rewrite text
+or images already embedded in a source page. New text and images are added as
+overlays instead.
+
 ## Downloads
 
 | Platform | Package | Status |
diff --git a/ROADMAP.md b/ROADMAP.md
index 938b677..61b0da8 100644
--- a/ROADMAP.md
+++ b/ROADMAP.md
@@ -5,15 +5,13 @@ reliable local processing, clear packaging, and a contributor-friendly project.
 
 ## Current release
 
-- **v0.3.0** is the latest published release. Its Windows package is unsigned
+- **v0.3.1** is the latest published release. Its Windows package is unsigned
   and remains available through GitHub Releases.
 - The Apple Silicon macOS build is signed and notarized. It bundles qpdf,
   Poppler, and Tesseract; LibreOffice remains optional for Office and PDF/A work.
 
-## Next release
+## Distribution
 
-- **v0.3.1** is being prepared for distribution through GitHub Releases and
-  [offpdf.com](https://offpdf.com).
 - The Windows x64 installer bundles qpdf, Poppler, Tesseract, and LibreOffice so
   the supported workflows run offline. It is distributed through GitHub Releases
   with an explicit unsigned warning while Authenticode signing is completed;
@@ -34,7 +32,7 @@ reliable local processing, clear packaging, and a contributor-friendly project.
 - Reduce the Windows package size without weakening offline functionality.
 - Add official Intel Mac and Linux packages.
 - Improve OCR language selection and optional language-pack guidance.
-- Expand editor support for annotations, links, and common form workflows.
+- Harden annotation, link, and AcroForm editing across more real-world PDFs.
 - Improve accessibility across keyboard navigation, focus states, and screen-reader labels.
 
 ## Known limitations
@@ -46,6 +44,14 @@ reliable local processing, clear packaging, and a contributor-friendly project.
 - Lossy compression rasterizes pages. Use text-preserving compression when text
   selection matters.
 - Complex Office conversions are best effort and may not reproduce every layout.
+- Edit PDF supports notes, highlights, underlines, strikeouts, ink annotations,
+  and common AcroForm text, checkbox, radio, combo, and list fields. XFA forms
+  are not supported.
+- In a multi-file Edit PDF job, only the first PDF's AcroForm can be filled.
+  Additional files that contain form fields must be removed from the job.
+- Flatten form fields converts form widgets to page content while preserving
+  other annotations. Flatten annotations converts all remaining annotations to
+  page content and requires form fields to be flattened when they are present.
 - Edit PDF adds new text, images, and shapes as overlays; it does not rewrite
   existing text or images inside the source document.
 - Auto-update is intentionally not enabled.