diff --git a/docs/deploy.md b/docs/deploy.md
index da9201a..ffe0699 100644
--- a/docs/deploy.md
+++ b/docs/deploy.md
@@ -155,8 +155,12 @@ volumes:
     The deploy layer injects `MOUNTS_DIR` and auto-creates the dir — but you
     **uncomment** the line and pick the container path (`/app/data` here), since
     that's app-specific and can't be auto-mounted.
-7.  Named volume with a **bare name** — ephemeral, auto-namespaced per service at
-    deploy time so it can't collide.
+7.  Named volume mounted at **`/app/cache`** — ephemeral scratch. The **right-hand
+    path is where your code writes**: `WORKDIR` is `/app`, so if your app writes to
+    `./cache` (or `/app/cache`), that's this mount. Same rule for logs (`/app/logs`)
+    and config (`/app/config`) — match the container path to where your code reads
+    and writes. The volume name is a bare name, auto-namespaced per service at deploy
+    so it can't collide.
 8.  Declare bare (`cache`, not `myapp_cache`). Deploy auto-prefixes it.
 
 !!! tip "Three tiers of storage"