aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/MESHBAY_DESIGN.md8
-rw-r--r--docs/USERGUIDE.md5
2 files changed, 13 insertions, 0 deletions
diff --git a/docs/MESHBAY_DESIGN.md b/docs/MESHBAY_DESIGN.md
index b44359f..9076ebc 100644
--- a/docs/MESHBAY_DESIGN.md
+++ b/docs/MESHBAY_DESIGN.md
@@ -2364,6 +2364,14 @@ Specific rules the download path is built on:
the frame source policy, the frame-ancestors policy and the legacy frame option.
Same-origin framing is what a streamed download needs; refusing every foreign
origin is unaffected.
+- **A downloaded file is opened in a tab only under a type that runs nothing.**
+ A tab on a `blob:` URL is a document of the hub's origin, with its session and
+ its keys; measured in Chrome and Firefox, HTML typed `text/html` runs there and
+ the same bytes typed `text/plain` do not. So "Open" is offered for PDFs, raster
+ images, audio, video and plain text, under a type chosen from the name — never
+ the one the browser would guess from the bytes — and not at all otherwise
+ (`downloads.openInTab`). Like resumability, whether a row can be opened is
+ declared by its target.
**Pause and resume, and where resumability actually lives.** A pause button that
quietly restarts a download from zero is worse than no pause button, so the
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index e190a92..7eeafbf 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -370,6 +370,11 @@ resume.
- **Browsing is never queued.** Posters, thumbnails, opening a photo or a
document to look at it — none of it takes a transfer slot. A busy group
browses exactly like an idle one.
+- **In a browser, Open is offered for PDFs, pictures, music, video and plain
+ text.** A web page, an SVG image or anything else that could run code is
+ not opened in a tab: the page would run as MeshBay, with your session. The
+ file is saved all the same — open it from your downloads folder. The
+ desktop application opens every file with your system's own program.
### Casting to a TV