Update documentation

Author: OpenHypervideo

CLAUDE.md

@@ -136,7 +136,7 @@ Note: Some libraries have custom/patched versions (raphael-connections.js, rapha
 - `'server'` — PHP backend available, data loaded/saved via AJAX to `src/_server/ajaxServer.php`
 - `'local'` — File System Access API active, data read/written via `StorageAdapterLocal` to a user-selected folder
 - `'needsFolder'` — File System Access API supported but no folder selected yet; launcher prompts user to pick a `_data` directory
-- `'download'` — No persistent storage available (Firefox/Safari, or any browser without File System Access API and no PHP); `StorageAdapterDownload` is used, which stores data in memory and lets users export/download it. Viewing and editing work; saves persist only until page reload.
+- `'download'` — No persistent storage available (Firefox/Safari, or any browser without File System Access API and no PHP); `StorageAdapterDownload` is used, which stores data in memory and lets users export/download it. Viewing and editing work; `canSave` is `false` (no persistent target); changes are exported via Save As. Data persists only until page reload.
 
 ### Application Modes
 
@@ -162,6 +162,7 @@ Note: Some libraries have custom/patched versions (raphael-connections.js, rapha
 4. **File-Based Persistence**: All data stored as JSON files (no database)
 5. **Event-Driven**: Timeline events, user actions broadcast to listeners
 6. **W3C Web Annotations**: Uses standardized annotation format with FrameTrail extensions
+7. **Guest Mode is orthogonal to storage mode**: `UserManagement.isGuestMode()` is an identity-layer flag — it means "editing without a server account", not "in download mode". A user can be in guest mode in any storage mode (local, download, or server). `StorageManager.canSave()` is the authoritative gate for save UI: it returns `false` for server mode when in guest mode, and delegates to `adapter.canSave` otherwise (`StorageAdapterDownload.canSave` is always `false`; `StorageAdapterLocal.canSave` is `true`). Always use `canSave()` rather than checking `isGuestMode()` or `storageMode` directly in save-related UI.
 
 **Important: FrameTrail instance vs global:**
 - The global `FrameTrail` object is the factory/registry. `FrameTrail.module()`, `FrameTrail.changeState()`, etc. are only available on **initialized instances** (the `FrameTrail` parameter passed into `defineModule` callbacks).

README.md

@@ -80,11 +80,12 @@ FrameTrail supports a wide range of embeddable content:
 
 ## Getting Started
 
-1. **Login** — Click the Edit button (top right) and log in with your admin account
+1. **Enter edit mode** — Click the Edit button (top right). In server mode, log in with your account or continue as a guest (name only). In local folder and in-memory modes, only the guest option is shown.
 2. **Create a hypervideo** — In the titlebar, click "New Hypervideo" and choose a video source
 3. **Add resources** — Click "Manage Resources" to upload or link media
 4. **Edit** — Drag resources onto the video timeline as overlays or annotations
-5. **Share** — Copy the URL or use iframe embedding
+5. **Save** — In server/local mode, Ctrl+S saves directly. As a guest, use Save As to export your changes as JSON.
+6. **Share** — Copy the URL or use iframe embedding
 
 ---
 

docs/ARCHITECTURE.md

@@ -97,9 +97,9 @@ FrameTrail.defineModule('ModuleName', function(FrameTrail) {
 | Module | Purpose |
 |--------|---------|
 | `Database` | Loads/saves all JSON data via the active storage adapter |
-| `StorageManager` | Selects and initializes the appropriate storage adapter |
+| `StorageManager` | Selects and initializes the appropriate storage adapter; exposes `canSave()` / `canSaveToServer()` |
 | `RouteNavigation` | URL parsing, hash parameters, environment detection |
-| `UserManagement` | Login, registration, user settings |
+| `UserManagement` | Login, registration, user settings, and guest editing (name-only, no account required) |
 | `Localization` | Multi-language string management (en-US, de) |
 | `ResourceManager` | Resource CRUD operations |
 | `ViewResources` | Resource gallery/grid view |
@@ -295,7 +295,7 @@ FrameTrail uses a strategy pattern for data persistence. The `StorageManager` mo
 |---------|-------|-----------|
 | Server | `StorageAdapterServer` | HTTP/HTTPS with PHP backend responding at `_server/ajaxServer.php` |
 | Local | `StorageAdapterLocal` | File System Access API available (Chrome/Edge) and folder selected |
-| Download | `StorageAdapterDownload` | Primary adapter when no server and no File System Access API (Firefox/Safari, or `file://` protocol). Stores data in memory; exports via Save As. Also available as a supplemental export tool in server and local modes. |
+| Download | `StorageAdapterDownload` | Primary adapter when no server and no File System Access API (Firefox/Safari, or `file://` protocol). Stores data in memory; `canSave` is `false` (no persistent target); exports via Save As. Also available as a supplemental export tool in server and local modes. |
 
 All adapters implement the same interface, so the rest of the application doesn't need to know which storage backend is active.
 

docs/DEPLOYMENT.md

@@ -54,7 +54,7 @@ Full editing without a server. Uses the [File System Access API](https://develop
 The `StorageAdapterLocal` class uses the File System Access API (`showDirectoryPicker`, `FileSystemDirectoryHandle`, etc.) to read and write JSON files and uploaded media. The browser asks for permission the first time you access a folder, then remembers it for the session.
 
 **Limitations:**
-- No user management (everyone is effectively admin)
+- Identity is name-only (a login dialog prompts for a display name before entering edit mode; no account or password required)
 - No PHP-based file processing (image optimization, video transcoding)
 - Browser must support File System Access API (Chrome/Edge only)
 
@@ -67,7 +67,7 @@ No server, no file system access required. FrameTrail automatically falls back t
 
 **How it works:**
 
-The `StorageAdapterDownload` holds all data in memory. Hypervideo data is passed via init options at startup (see [Inline on a Page](#inline-on-a-page) below). Viewing and editing are fully functional. The Save button is disabled (since there is nowhere to persist); use **Save As** to export a JSON snapshot that can be reloaded later.
+The `StorageAdapterDownload` holds all data in memory. Hypervideo data is passed via init options at startup (see [Inline on a Page](#inline-on-a-page) below). Viewing is always available. For editing, a login dialog prompts for a display name (guest mode — no account needed). The Save button is disabled (no persistent target); use **Save As** to export a JSON snapshot that can be reloaded later.
 
 **Limitations:**
 - No persistence — changes are lost on page reload unless exported via Save As