diff --git a/docs/latest/.sha b/docs/latest/.sha
index abe3d29a2..59266b289 100644
--- a/docs/latest/.sha
+++ b/docs/latest/.sha
@@ -1 +1 @@
-412ea766bb08d8247f32ff631b578a1a73da4c10
\ No newline at end of file
+f476b2945979ba80614893f0cce0c42bae061e52
diff --git a/docs/latest/api/shell.md b/docs/latest/api/shell.md
index c3970b235..465838464 100644
--- a/docs/latest/api/shell.md
+++ b/docs/latest/api/shell.md
@@ -87,6 +87,10 @@ Rejects if there was an error while deleting the requested item.
 This moves a path to the OS-specific trash location (Trash on macOS, Recycle
 Bin on Windows, and a desktop-environment-specific location on Linux).
 
+The path must use the default path separator for the platform (backslash on
+Windows). Use `path.resolve()` from the `node:path` module to ensure correct
+handling on all filesystems.
+
 ### `shell.beep()`
 
 Play the beep sound.