summaryrefslogtreecommitdiffstats
path: root/docs/USERGUIDE.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/USERGUIDE.md')
-rw-r--r--docs/USERGUIDE.md15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 8a55928..d6ce327 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -556,6 +556,21 @@ from a page. If even that is unavailable, a download under 512 MB is collected i
memory and handed over; a larger one asks where to put it, because a tab does not
survive a multi-gigabyte blob.
+**What has been exercised**, as of 2026-08-15, so the next person knows which of
+this is measured and which is designed:
+
+| Path | Browser | State |
+|---|---|---|
+| Streamed into a granted folder | Chrome | works |
+| Streamed by the service worker | Firefox | works — 180 MB, written to disk |
+| Collected in memory (no folder, no worker) | any | works, bounded at 512 MB |
+| Save As for a download over 512 MB | Chrome | works |
+| Multi-gigabyte download, any path | — | designed for, not yet measured |
+
+The 180 MB run is the one that matters most, because the service worker is the
+only way Firefox writes a download to disk rather than building it in a tab. It
+has not been tried at the scale it exists for.
+
A finished download offers **Open** in the transfers widget when it went into a
folder you granted: the file is handed to a new tab and the browser decides what
to do with it. That is the whole of what a web page can do here — it cannot start