# Part 1 · Notifications

## 1.1 Reading the bell

**Who** · Everyone signed in.

**Where** · The bell in every page's header, beside the workspace.

**Before you start** · Nothing. The bell shows how many are unread; it checks again every 30 seconds while the page is
in view.

**The steps**
1. Open the bell: the newest ten, **New** (unread, with a dot) above **Earlier**. Each says what happened, where (a
   workspace, or **Your account**) and when.
2. Choose one to open it: it is marked read, its workspace is opened if it is another of yours, and you land where it
   points (the export, the page it is about). A button under it (**Download it**) does the same.
3. **Mark all as read** (the double tick), or the cog for **What reaches you**, or **See them all**.

**What the record shows** · Nothing new: reading changes only your own notices.

**Who is told** · Nobody.

**What can go wrong**
- *"You're all caught up".* Nothing has come yet, or you chose not to have this kind in the app (1.3).
- *A notice about something you can't open.* It can't happen: the app asks, before telling anyone, whether they may
  see what it is about.

## 1.2 Going through all of them

**Who** · Everyone signed in.

**Where** · The bell › **See them all** (`/me/notification`).

**Before you start** · Nothing.

**The steps**
1. **All**, **Unread** or **Read**; filter by workspace (or **Your account**) and by kind; search the words.
2. The switch on a row marks it read or unread. The folder opens it, as on the bell.
3. The bin deletes it, after you confirm. **Mark all as read** above the list.

**What the record shows** · Nothing: these are your own notices. They are kept 90 days, read or not.

**Who is told** · Nobody.

**What can go wrong**
- *Something you remember is gone.* It was older than 90 days, or you deleted it. The logs (audit, e-mail) keep their
  own record.

## 1.3 Choosing what reaches you

**Who** · Everyone signed in.

**Where** · Your menu › **What reaches you, and how**, or the cog on the bell (`/me/notification/preference`).

**Before you start** · Only the kinds that could reach you are listed: what your roles let you see.

**The steps**
1. Each kind has a switch per channel: **In the app**, **By e-mail**, **In the daily digest**. A dash means nothing of
   that kind comes that way.
2. Switch one: it is saved at once.
3. **Security** shows **Always** and no switch: a new sign-in, two-factor turned on or off, a locked account always
   reach you, in the app and by e-mail.

**What the record shows** · Your choices, kept with your account.

**Who is told** · Nobody.

**What can go wrong**
- *"That choice isn't yours to make here."* That kind can't reach you, or it is security.

## 1.4 Quiet hours and the daily digest

**Who** · Everyone signed in.

**Where** · What reaches you › **Quiet hours and the digest**.

**Before you start** · The hours are in your time zone (your menu › Language and region).

**The steps**
1. **Hold e-mails overnight**, then **Quiet from** and **Quiet until**. An e-mail that comes in those hours waits until
   they end. The bell isn't held, and security still comes at once.
2. **Send my daily digest at**: the hour your digest comes, only on days something you chose for it happened.
3. **Save changes**.

**What the record shows** · Your own settings (the audit log keeps the change, as for any setting).

**Who is told** · Nobody.

**What can go wrong**
- *No digest came.* Nothing you chose for the digest happened that day, or no kind has **In the daily digest** on (1.3).

## 1.5 Muting a workspace

**Who** · Anyone in more than one workspace, or wanting quiet from one.

**Where** · What reaches you › **Workspaces**.

**Before you start** · Nothing.

**The steps**
1. Switch a workspace off: nothing from it reaches you, on any channel, except security.
2. Switch it on again to hear from it.

**What the record shows** · Your choice, kept with your account.

**Who is told** · Nobody.

**What can go wrong**
- *A security notice came anyway.* Security always comes.

## 1.6 Choosing an event's channels and in-app words (Service)

**Who** · The Service (`notification.manage`).

**Where** · The platform menu › **Notifications** › an event's rule, or its template.

**Before you start** · Each person narrows the channels for themselves; the rule says which they may have.

**The steps**
1. On the rule, **Where it reaches people**: **In the app**, **By e-mail**, **In the daily digest**, each a switch. At
   least one; a rule the app relies on (locked) keeps **By e-mail**.
2. **Save changes**. Release updates no longer change this rule.
3. On the template, **On the bell and in the digest**: one short line, **bold** allowed. It can't use a one-time link
   (an invitation's, a reset's): those are never kept.

**What the record shows** · The audit log: **Notification rule changed** (its channels before and after), and the
template's new version.

**Who is told** · Nobody.

**What can go wrong**
- *"Choose at least one way it reaches people."*
- *"The app relies on this e-mail: it keeps going by e-mail."*
- *"The in-app words are kept: a one-time link or code can't go in them."*