diff --git a/README.md b/README.md
index 5666fb22..609ac5e8 100644
--- a/README.md
+++ b/README.md
@@ -120,8 +120,8 @@ Please report issues on our [GitHub issues](https://github.com/ocrmypdf/OCRmyPDF
 ## Feature demo
 
 ```bash
-# Add an OCR layer and convert to PDF/A
-ocrmypdf input.pdf output.pdf
+# Add an OCR layer and require PDF/A
+ocrmypdf --output-type pdfa input.pdf output.pdf
 
 # Convert an image to single page PDF
 ocrmypdf input.jpg output.pdf
diff --git a/docs/release_notes.md b/docs/release_notes.md
index 2f0b2bf1..657847bc 100644
--- a/docs/release_notes.md
+++ b/docs/release_notes.md
@@ -109,7 +109,7 @@ official when it's tagged and posted to PyPI.
 - Recommended: `ghostscript` (used to be Required)
 - Optional: `verapdf` for fast PDF/A validation (new dependency)
 - Requires: `fpdf2` for text layer rendering (new dependency)
-- Recommended: `typer` with `cyclopts` in misc scripts (new dependency)
+- Recommended: replace `typer` with `cyclopts` in misc scripts (new dependency)
 - See docs/maintainers.md for details.
 
 **Migration guide for plugin developers**