aboutsummaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/QUICKSTART.md23
-rw-r--r--docs/USERGUIDE.md8
2 files changed, 19 insertions, 12 deletions
diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md
index ea75cab..cfb0743 100644
--- a/docs/QUICKSTART.md
+++ b/docs/QUICKSTART.md
@@ -48,8 +48,11 @@ Three things, and it is worth knowing which is which before you start:
- [ ] **An email address** you can read — account sign-up sends a code to it.
- [ ] **About half an hour**, plus however long a first index takes — which
depends on how much you are sharing, and does not need watching.
-- [ ] **Terminal access** to that machine. Everything below works over SSH; no
- graphical session is needed on the node.
+- [ ] **Terminal access** to that machine. Everything on the node works over
+ SSH; no graphical session is needed there.
+- [ ] **The desktop application, on any computer with a screen** — the node
+ machine or another one. Creating a group is done there and only there
+ (Step 6).
You do **not** need a static IP, a domain name, port forwarding, or a router
you control. Two residential ISPs have been measured working without any of it.
@@ -65,11 +68,11 @@ distribution:
|---|---|---|
| **`meshbay-common`** — required, install it first | `.deb` | `.rpm` |
| **`meshbay-node`** — the daemon that hosts your files | `.deb` | `.rpm` |
-| `meshbay-client` — the desktop application, optional | `.deb` | `.rpm` |
+| `meshbay-client` — the desktop application | `.deb` | `.rpm` |
-You need the first two. The desktop application is worth having if this machine
-has a screen, but nothing in this guide requires it: a terminal and a browser
-are enough.
+The node machine needs the first two. The desktop application goes on whichever
+computer you will sit at — this one if it has a screen, another one otherwise:
+Step 6 needs it, because a group cannot be created from a browser.
Put them in one directory — the next step installs them together.
@@ -91,7 +94,8 @@ sudo apt install ./meshbay-common_*.deb ./meshbay-node_*.deb
sudo dnf install ./meshbay-common-*.rpm ./meshbay-node-*.rpm
```
-Add `./meshbay-client_*` to that line to install the desktop application too.
+Add `./meshbay-client_*` to that line if this is also the computer you will use
+the desktop application on.
`meshbay-common` carries everything the others need, so there is nothing else
to install and no Python environment to set up. **ffmpeg**, required for video
@@ -208,7 +212,10 @@ correct.
## Step 6 — Create the group
-In the browser, on meshbay.org: **Create group** in the sidebar.
+In the **desktop application**, signed in with your account: **Create group**
+in the menu under your avatar, top right. It is there once the node key from
+Step 4 is linked to your account. A browser does not offer it: creating a group
+is a desktop-application feature, by design.
- **Name** — anything. It is shown to members as `name@yourusername`.
- **Join policy** — leave it on **Invite only**. The alternative, *Open*, lists
diff --git a/docs/USERGUIDE.md b/docs/USERGUIDE.md
index 42103d6..9d1749f 100644
--- a/docs/USERGUIDE.md
+++ b/docs/USERGUIDE.md
@@ -388,9 +388,9 @@ that matters to you.
### Backing up your phone
-On the Android application, **Phone → Android Sync** in the side menu backs up
-your phone's photos, contacts, calendar, text messages and the files of
-folders you choose to a group.
+On the Android application, **Android Sync** in the menu under your avatar,
+top right, backs up your phone's photos, contacts, calendar, text messages and
+the files of folders you choose to a group.
Only your **personal profile** is backed up. If your phone has a work profile,
nothing in it is sent, and MeshBay installed inside the work profile offers no
@@ -503,7 +503,7 @@ notification and on the Android Sync page, and tries again the next day.
### Search
-The magnifying glass in the sidebar searches **across every group you are in**
+The magnifying glass in the top bar, left of the bell, searches **across every group you are in**
at once, with a Files / Videos / Music / Photos view each.
A file that two groups both have is **one result**, not two — identity is the