aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/MESHBAY_DESIGN.md1
-rw-r--r--docs/USERGUIDE.md6
2 files changed, 7 insertions, 0 deletions
diff --git a/docs/MESHBAY_DESIGN.md b/docs/MESHBAY_DESIGN.md
index 7c5dce9..fdf08f9 100644
--- a/docs/MESHBAY_DESIGN.md
+++ b/docs/MESHBAY_DESIGN.md
@@ -2817,6 +2817,7 @@ destructures what it needs — a new application does not get a bespoke prop lis
| `transportRef`, `gekRef` | **refs**, never state, so a reconnect does not re-render every application |
| `deviceReady` | **the exception, and why it is a prop.** A ref not re-rendering is right for a transport reached into on demand and wrong for a *fact about the connection* an application renders from |
| `mayUpload` | computed once; a second derivation would eventually disagree with the first |
+| `linkFor(entry \| folderPath)` | the `#/name@owner/path` link "Copy link" puts on the clipboard (§8.4), or null where none can be named. The group page builds it from the hub's row; Search from each result's own group and unprefixed path. An application offers the action only when this returns a link, and copies with `copy-link.js` `copyLink` |
An application that needs local state owns it. One pattern is worth carrying: **any
notion of "current location within the group" resets on group change**, because a
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index d7f0624..ea81c76 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -304,6 +304,12 @@ file browser — sort, select, download, preview.
Files there. Only members get anywhere with such a link — anyone else is told
the group is unknown — and someone not signed in is asked to sign in first,
then taken where the link pointed. Renaming the group breaks these links.
+- **Copy link** gives you that address for one file or folder: right-click it,
+ or tick it and use the link button in the toolbar (the way on a phone). Music
+ has it in a track's menu (**⋯** on a phone), Photos when you right-click a
+ photo or in the photo viewer's bar, and the video player and file preview
+ have a link button next to Download. Search offers the same, pointing at the
+ group each result comes from.
### Chat