# Part 1 · The frame

## 1.1 Choosing light, system or dark

**Who** · Everyone who opens the app.

**Where** · The three small buttons at the top right of every page, and of the sign-in page: a sun, a half-filled
circle, a moon. On a phone they are in your menu (your initials, at the top right).

**Before you start** · Nothing. A first visit follows the device's own setting (System).

**The steps**
1. Press the sun for Light, the moon for Dark, or the half circle for System (whatever the device is set to).
2. The page changes at once. There is nothing to save.

**What the record shows** · The choice is kept in this browser (a cookie, `appearance`), so the next page and the next
visit open in it without a flash of the other theme. Another browser or device keeps its own choice.

**Who is told** · Nobody.

**What can go wrong**
- *The page opens dark although I chose Light on my phone.* The choice belongs to each browser. Choose again on this
  one.
- *System doesn't follow my laptop at night.* System follows the device's own light or dark setting, not the time of
  day. Change it on the device, and an open page follows straight away.

## 1.2 Folding the menu to its icons

**Who** · Everyone who opens the app, on a screen wider than a phone.

**Where** · The square button at the start of the page header, or the thin rail on the menu's edge. The keyboard
shortcut is Ctrl B (⌘ B on a Mac).

**Before you start** · Nothing.

**The steps**
1. Press the button. The menu folds to its icons and the parent's mark.
2. Point at an icon, or move to it with Tab: its name shows beside it in bold, as if the menu were open.
3. A group's icon opens a small menu of its pages beside it. Enter opens it, the arrow keys move through it, Escape
   closes it.
4. Press the button again to unfold the menu.

**What the record shows** · Whether the menu is folded is kept in this browser (a cookie, `sidebar_state`). S2 keeps it
per account instead.

**Who is told** · Nobody.

**What can go wrong**
- *There is no button on my phone.* On a phone the menu is a drawer: the same button opens it over the page, with the
  names written out.
- *An item I used yesterday is gone.* The menu holds only what your access lets you open. If your access changed, the
  item goes with it. Ask someone who manages access in your workspace.

## 1.3 When a page can't be shown

**Who** · Everyone.

**Where** · Any address. The page is drawn in the sign-in frame: the brand panel on one side, the reason on the other.

**Before you start** · Nothing.

**The steps** · Read the reason, then press **Go back** or **Go to the home page**.

| You see | It means |
|---|---|
| *This page isn't open to you* (403) | Your access doesn't include this page. It never says which permission is missing. |
| *There's no page here* (404) | The address is mistyped, or the page has moved. |
| *Too many tries* (429) | Wait a moment, then try again. |
| *Back shortly* (503) | The app is being updated. |
| *Something went wrong* (500) | An error on the server. It has been logged. |

A form left open so long that its page expired doesn't show an error page: it goes back to the form with a short
note, *The page had been open a long time, so it was refreshed*.

**What the record shows** · The server's log holds server errors. A refusal is not logged on its own: the pages that
matter log who opened them (the audit log, since S10).

**Who is told** · Nobody.

**What can go wrong**
- *I was sent a link and it says the page isn't open to me.* The link is right; your access doesn't reach it. Ask the
  person who sent it, or someone who manages access.

## 1.4 Seeing which workspace you're in

**Who** · Everyone working inside a workspace. (The word is the product's own: a School, a Loop. This manual says
workspace.)

**Where** · The chip at the top right of every page, beside the theme switch: the workspace's initials on a dark
square, and its name, with a small arrow when you are in other workspaces too. On a phone only the initials show.

**Before you start** · Nothing. With no workspace open (the sign-in page, an error page) there is no chip.

**The steps** · Look at the chip. Everything the page lists, finds or saves belongs to that workspace and no other.

**What the record shows** · Every record made while you work is kept in that workspace, and every change you make is
logged in it (the audit log, since S10). The server's own log names the workspace too, so a problem can be traced to it.

**Who is told** · Nobody.

**What can go wrong**
- *I belong to two workspaces and want the other one.* Press the chip and choose (the People manual, 1.2).
- *I can't find a record a colleague in another workspace can see.* Each workspace's records are its own; nothing
  shows across them, even by its address. Ask them to share it the way the product allows.