diff --git a/docs/configuration.md b/docs/configuration.md
index 79e94ed51..fa87ce629 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -833,7 +833,8 @@ modes are available:
 
     The default is `auto`.
 
-    Read more about this in the [OCRmyPDF
+    For the `skip`, `redo`, and `force` modes, read more about OCR
+    behaviour in the [OCRmyPDF
     documentation](https://ocrmypdf.readthedocs.io/en/latest/advanced.html#when-ocr-is-skipped).
 
 #### [`PAPERLESS_ARCHIVE_FILE_GENERATION=<mode>`](#PAPERLESS_ARCHIVE_FILE_GENERATION) {#PAPERLESS_ARCHIVE_FILE_GENERATION}
diff --git a/docs/migration-v3.md b/docs/migration-v3.md
index 67bbaa90c..39166c4a6 100644
--- a/docs/migration-v3.md
+++ b/docs/migration-v3.md
@@ -106,7 +106,7 @@ PAPERLESS_DB_OPTIONS="sslmode=require;sslrootcert=/certs/ca.pem;pool.max_size=10
 
 ## OCR and Archive File Generation Settings
 
-The settings that control OCR behaviour and archive file generation have been redesigned. The old settings that coupled these two concerns together are **removed** — there are no migration shims.
+The settings that control OCR behaviour and archive file generation have been redesigned. The old settings that coupled these two concerns together are **removed** — old values are not silently honoured; a startup warning is logged if any removed variable is still set in your environment.
 
 ### Removed settings
 
@@ -154,8 +154,6 @@ PAPERLESS_OCR_SKIP_ARCHIVE_FILE=with_text
 PAPERLESS_ARCHIVE_FILE_GENERATION=auto
 ```
 
-Paperless will emit a startup warning if the old environment variables are still set.
-
 ### Remote OCR parser
 
 If you use the **remote OCR parser** (Azure AI), note that it always produces a
diff --git a/docs/usage.md b/docs/usage.md
index 6da6c4d77..c245b63b3 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -134,9 +134,9 @@ following operations on your documents:
 !!! tip
 
     This process can be configured to fit your needs. If you don't want
-    paperless to create archived versions for digital documents, you can
-    configure that by configuring
-    `PAPERLESS_OCR_SKIP_ARCHIVE_FILE=with_text`. Please read the
+    paperless to create archived versions for born-digital documents, set
+    [`PAPERLESS_ARCHIVE_FILE_GENERATION=auto`](configuration.md#PAPERLESS_ARCHIVE_FILE_GENERATION)
+    (the default). To skip archives entirely, use `never`. Please read the
     [relevant section in the documentation](configuration.md#ocr).
 
 !!! note