← Commit history

add the client-vs-server sub-readme (what lives in your browser vs on the server) and its card

Drew Owens ·9ba5a6c1f6 · ·parent a4cf340
4 files changed +97
README.md+9
@@ -384,6 +384,15 @@ independent and a blocked tab kept filling the changelog with edits the plan nev The practical advice is unchanged: for now, edit one at a time, or reload before a long editing run. +## Your view and the shared plan: what lives where++<table>+<tr>+<td width="104"><a href="client-vs-server/README.md"><img src="client-vs-server/client-vs-server-icon.png" width="112" alt="Your view and the shared plan"></a><br><sub>&nbsp;&nbsp;&nbsp;Your&nbsp;view&nbsp;vs&nbsp;the&nbsp;plan&nbsp;&nbsp;&nbsp;</sub></td>+<td>Folds, filters, the lens and the text size stay in your browser, while every row, date and owner lives on the server and is the same for everyone. <strong><a href="client-vs-server/README.md">What lives where</a></strong> sorts each setting into this tab, this browser or the plan's server, with a one-page diagram. Read it before a team review, so you know which of your clicks only change your own screen and which change everyone's.<br><br><a href="client-vs-server/README.md">The diagram and the full list</a></td>+</tr>+</table>+ ## Keyboard shortcuts  | Key | Action |
client-vs-server/README.mdadded+88
@@ -0,0 +1,88 @@+# What stays on your screen, and what everyone sees++Adom Gantt keeps two kinds of state apart. How **you** are looking at a plan (folds,+filters, the lens, the text size) stays in your browser and never reaches anyone else.+The **plan itself** (every row, date, owner and section) lives on the server, and every+teammate sees a change to it within about a second.++![Where each thing lives: only this tab, this browser, the plan's server](where-it-lives.png)++## The short answer++Pressing **Collapse all**, folding a section, filtering to **Unassigned**, turning on+**Current** or **Overdue**, or switching to the Table changes only your screen. Your+teammates keep whatever they had.++Dragging a bar, changing an owner or a status, renaming a section, pressing+**Auto-schedule**, or adding and deleting rows changes the plan, so it changes on every+screen.++## Only this tab++Gone when you reload, and not shared even with your other tabs:++| What | Notes |+|---|---|+| The section, Milestone and Dependencies chips in the legend | Hiding or dimming a section is a quick look, not a setting |+| Your selection, the open editor, your scroll position | Your selection is also shown to others as a highlight (see below), but it is never saved |+| Undo history | Ctrl+Z undoes this tab's own edits only |+| "See what the team sees" | The owner's preview of the team view lasts until the tab closes |++## This browser++Remembered for you across reloads, kept per plan, and never sent to the server. Every+tab of the same plan in the same browser shares them; another computer starts fresh.++| What | Notes |+|---|---|+| Collapse all, each section's fold | The table follows the chart's folds |+| Owner, Current, Overdue and tag filters | The chart and the table share one owner filter |+| The lens: Gantt, Table, Analytics, Setup | Analytics and the owner cards on Setup are hidden for teammates |+| Days, weeks or months; text size; light or dark; milestone style; Today line | |+| Critical path highlight | Only the highlight. Auto-schedule, which moves dates, is a plan change |+| Name column width; table column widths, sort and owner pick | |+| Which legend chips are folded away | The "18 tags" and "50 sections" chips |++A browser that has never opened the plan starts from the plan's own defaults: the+`project.view` block in the data file can set the lens, grain, milestone style, theme+and name column width. Once you change one, your choice wins in that browser.++## The plan's server++Saved by the adom-gantt server and shared with everyone the plan is shared with.++| What | Notes |+|---|---|+| Every task and milestone | Name, dates, owner, status, notes, tags, effort, provenance link, dependencies |+| Sections | Names, colours, leads, tags and order |+| Row order and tag colours | |+| Added, deleted, pasted and imported rows | A delete can be undone by the tab that made it |+| Changelog | Every change, who made it and when, in an append-only file the server checks for tampering |+| Backups | Daily, and before every import or compaction; the last 30 are kept |+| Sharing (only me, the org, anyone signed in) | Owner only |+| Google Chat digest | Owner only |+| Sign-in sessions and the agent key | Never shown in the page |++Edits save in about a second after you stop. If two people save at the same moment the+page merges the other person's rows under yours and saves again. If both edited the+same row within a second or two, the later save wins for that row.++## Live, never saved++The server also passes along two things it does not keep: **who has the plan open**+(the initials in the legend) and **which rows each person has selected or open** (rows+tinted in that person's colour, with their initials). Both vanish when the person+closes the tab.++## Worth knowing++- **The "starts" date button moves the whole plan.** It is not a view setting: picking a+  new start date shifts every date in the plan, for everyone. It is undoable from the+  tab that did it.+- **A filter can hide new work.** If you filter to one owner and a teammate adds a row+  for someone else, you will not see it until you clear the filter. The legend counts+  ("13 of 30" on a section) say how much is hidden.+- **Your folds and filters follow you between tabs, not between computers.** Your+  laptop and your desktop each remember their own.++Back to [Sharing a plan with your team](/adom/adom-gantt#sharing-a-plan-with-your-team).
client-vs-server/client-vs-server-icon.pngadded
⋯ 1 unchanged line ⋯
client-vs-server/where-it-lives.pngadded
⋯ 1 unchanged line ⋯