2 files changed, 6 insertions, 5 deletions
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/downloads.js b/packages/meshbay-hub/src/meshbay_hub/static/downloads.js
index c790394..9c23d3c 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/downloads.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/downloads.js
@@ -649,8 +649,9 @@ async function _attemptStreamedDownload(filename, size, attempt,
     // writing to the stream stalls that download where we cannot see it or
     // resume it, and an idle worker is terminated within seconds, taking the
     // stream with it. A pause button here would restart from zero, which is
-    // worse than not offering one. §6.5 of ~/next/improve-downloads.md records
-    // what giving Firefox and Safari a resumable target would cost.
+    // worse than not offering one. Offering Firefox and Safari a resumable
+    // target means a resumable sink of our own, which is a larger piece of work
+    // than the button it would enable.
     pausable: false,
     writable: {
       write: (bytes) => { lastWrite = Date.now(); return writer.write(bytes); },
diff --git a/packages/meshbay-hub/src/meshbay_hub/static/file-utils.js b/packages/meshbay-hub/src/meshbay_hub/static/file-utils.js
index 99d9f9a..b732734 100644
--- a/packages/meshbay-hub/src/meshbay_hub/static/file-utils.js
+++ b/packages/meshbay-hub/src/meshbay_hub/static/file-utils.js
@@ -451,9 +451,9 @@ async function downloadEntry(transfers, transport, gek, entry) {
     },
 
     // After the target, never before: a granted slot has to be taken up within
-    // the node's deadline, and opening a target can outlast it. See §8.1 of
-    // ~/next/improve-downloads.md — the other order was tried and cost two of
-    // three downloads.
+    // the node's deadline, and opening a target can outlast it — a Save As
+    // dialog waits for a person. Asking for the slot first loses it to the
+    // grant deadline while the dialog is open.
     makeLease: () => transport.openTransfer({
       kind: 'download', bytes: entry.size, chunks: totalChunks }),