Collaboration

# Part 7 — Collaboration

When the project starts having other readers (a partner, an editor, an extended family member), you'll use the **Collaboration panel** on the project detail page.

## 7.1 Reviewer roles

There are three roles:

- **Author** — full editing access (you, by default)
- **Reviewer** — can leave comments and suggestions, but can't commit edits
- **Approver** — like Reviewer plus the right to approve content for publication

Roles are set in the **Reviewer assignment** card. Click **+ Assign** to pick a user from the project roster and choose a role. Assignments are **per language** — you can make someone a Reviewer of the EN version only.

## 7.2 Comments

Below the reviewer card is a **Comments** section, also split per language (EN comments live separately from FR comments).

To leave a comment:

1. Type in the box at the bottom of the panel
2. Use **`@name`** to mention another collaborator (they'll get a notification)
3. Click **Post**

Comments are **threaded** — click **Reply** under any comment to start a thread. Click **Resolve** to mark a thread as handled (it's hidden by default but can be re‑shown with the **Show resolved** checkbox).

## 7.3 Suggestions (tracked changes)

For text content, there's a toggle at the top of the editor that switches between:

- **✏ Edit mode** — your changes are saved directly (Authors / Approvers only)
- **✦ Suggest mode** — your changes become **suggestions** that an Author or Approver later accepts or rejects

In Suggest mode, your edits show up as colored **tracked changes**:

- **Green** for insertions
- **Red strikethrough** for deletions
- **Yellow** for modifications (a delete + insert pair)

Below the textarea, an optional **Rationale** field lets you explain *why* you're suggesting the change. Click **✦ Submit suggestion** to send it.

Authors / Approvers see incoming suggestions in the **Suggestions** panel and can **Accept** or **Reject** each one.

## 7.4 Approval workflow

Each language has an **Approval state**:

```
Draft  →  In review  →  Approved
                    ↘
                     Changes requested  →  In review  (resubmitted)
```

- An Author moves the project from **Draft** to **In review**
- An Approver clicks **✓ Approve EN** or **✓ Approve FR** to mark that language ready
- An Approver can also click **Request changes** with a note that explains what to fix

**EN and FR approval are completely independent.** You can ship the English version while the French is still in review.

## 7.5 Live presence

While you're editing, you'll see small avatar chips at the top of the pane showing **who else is in the same chapter right now** and whether they're typing. A subtle line under the textarea shows their selections.

This is per‑language — peers editing the French version won't show in the English pane and vice‑versa.

## 7.6 Revision timeline

The **Revision timeline** card at the bottom of the collab panel rolls up every event — edit, suggestion, comment, approval — into one feed. You can filter by:

- **Language** (all / EN / FR)
- **Stage** (research / story / media / delivery)
- **Kind** (edits / suggestions / comments / approvals)
- **User**

---