1 files changed, 23 insertions, 0 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 7f69712..eec61d9 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -529,6 +529,29 @@ look at what was sent, move it, or empty it without hunting through the tree.
 - Uploads are attributed to the identity the node pinned for that member, and that is what
   decides who may delete the file later — not anything the hub says.
 
+### Selecting files, and where transfers live
+
+The Files panel has a **Select** button. Turning it on puts a checkbox on every
+row — files and folders — and the **⋮ Actions** button next to it acts on what is
+ticked: download, play, view, download folders as a zip, delete. There is no
+per-row menu: several transfers at once is the normal case, and starting them one
+context menu at a time was the thing that made it awkward.
+
+Selection is remembered as you walk into folders, so you can tick something in
+one and something else in another before choosing an action.
+
+**Transfers run outside the page.** They are listed in the widget next to the
+bell, with a progress bar, the current rate, and a cancel button each:
+
+- Leaving the group, or the group page, does not stop them. The connection stays
+  open until the last transfer using it is finished.
+- **Signing out cancels them all** — they are moving data on a token that is about
+  to stop being yours.
+- Cancelling stops the work, not just the display; a partly written file is left
+  where you told the browser to put it.
+- Rates are measured over the last few seconds, so a stalled transfer reads as
+  stalled rather than reporting the average it once managed.
+
 ### Downloading a folder as a zip
 
 Any member can take a whole folder: **⋮ → Download as zip** on the folder's row.