summaryrefslogtreecommitdiffstats
path: root/docs/USERGUIDE.md
diff options
context:
space:
mode:
authorChristophe Besson <cbesson@gmail.com>2026-10-05 11:53:57 +0200
committerChristophe Besson <cbesson@gmail.com>2026-10-05 11:53:57 +0200
commit8f25294b0f6bc3f292442edd69a2e149f0717b52 (patch)
tree58cfe661b15fce395ab5116f19341bdb6a5b07fe /docs/USERGUIDE.md
parent28752696f376eb11feb686580a435b166750a723 (diff)
downloadmeshbay-8f25294b0f6bc3f292442edd69a2e149f0717b52.tar.gz
feat: open a group, a folder or a file from a #/name@owner link
A group can now be reached by the handle shown under its name, and a path after it points inside the group: #/name@owner/root/dir/file downloads the file and opens Files on its folder; a folder opens Files there. The handle is resolved in the client against the account's own /v1/groups/mine, so no hub route answers for a name and nobody can probe for one. While a group is open the address shows the handle (replace, no history entry); a linked path is taken out of the address once acted on, so a reload does not download twice. Signing in no longer sends everyone home: the form stood in for the page the address named, and that is where a link opened signed out was going. group-link.js holds the parsing and lookups, executed whole by test_group_link.py; harness/group_link_probe.py drives the router in Chrome. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'docs/USERGUIDE.md')
-rw-r--r--docs/USERGUIDE.md7
1 files changed, 7 insertions, 0 deletions
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 97ea679..d7f0624 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -297,6 +297,13 @@ file browser — sort, select, download, preview.
- **Right-click a file or folder** for the same actions as the toolbar, listing
only the ones that apply to it. On a ticked row the menu acts on everything
ticked, like the toolbar does.
+- **A link to a group, a folder or a file.** While a group is open the address
+ bar shows `https://<hub>/#/name@owner` — the name under the group's title.
+ Add a path after it to point inside the group:
+ `#/name@owner/root/folder/photo.jpg` downloads that file, and a folder opens
+ 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.
### Chat