diff --git a/aider/website/docs/more/edit-formats.md b/aider/website/docs/more/edit-formats.md
index 6c590d8100b..4cfc8d9bc47 100644
--- a/aider/website/docs/more/edit-formats.md
+++ b/aider/website/docs/more/edit-formats.md
@@ -98,3 +98,9 @@ to reduce their "lazy coding" tendencies with other edit formats.
 +class MathWeb:
 ```
 ````
+
+## editor-diff and editor-whole
+
+These are streamlined versions of the diff and whole formats, intended to be used
+with `--editor-edit-format` when using
+[architect mode](/docs/usage/modes.html).
diff --git a/aider/website/docs/usage/modes.md b/aider/website/docs/usage/modes.md
index a21f36e9d4c..9857a39de29 100644
--- a/aider/website/docs/usage/modes.md
+++ b/aider/website/docs/usage/modes.md
@@ -44,6 +44,10 @@ After the main model replies, aider will offer to edit the files based on the re
 This request goes to the "editor" model.
 Aider has built in defaults to select an editor model based on your main model.
 Or, you can choose an editor model yourself with `--editor-model <model>`.
+The 
+["editor-diff" and "editor-whole" edit formats](/docs/more/edit-formats.html#editor-diff-and-editor-whole)
+are recommended for use
+by an Editor model.
 
 Architect mode produces better results than code mode, but uses two LLM requests.
 This probably makes it slower and more expensive than using code mode.