diff --git a/docs/abra/upgrade.md b/docs/abra/upgrade.md
index aedc2c1..31fab2d 100644
--- a/docs/abra/upgrade.md
+++ b/docs/abra/upgrade.md
@@ -55,8 +55,18 @@ And test things work.
 
 ### `0.10.x-beta` -> `0.11.x-beta`
 
-* We now ensure that `$ABRA_DIR/servers` has stricter permissions (`0600`).
-  See [`#592`](https://git.coopcloud.tech/toolshed/abra/pulls/592) for more.
+* Timeouts are no longer used unless specifically set in the app `.env` file,
+  e.g `TIMEOUT=180`. Recipe maintainers should remove defaults so that these
+  are not imposed on operators. See
+  [`#596`](https://git.coopcloud.tech/toolshed/abra/issues/596).
+
+* `--ignore-env-version` has gone away as a global flag. `--latest` is now
+  present on `abra app deploy`. See
+  [`#617`](https://git.coopcloud.tech/toolshed/abra/issues/617).
+
+* We now ensure that `$ABRA_DIR/servers` has stricter permissions (`0600`). See
+  [`#592`](https://git.coopcloud.tech/toolshed/abra/pulls/592) for more. No
+  migration step should be required.
 
 ### `0.9.x-beta` -> `0.10.x-beta`