# Reviewer Guide

> **You are a Reviewer.** You perform second-pass quality checks on VTT content after a Linguist has submitted it, then approve or request changes. You also handle **Final Review** — making the final go/no-go decision before files are delivered to the client.

---

## Your Sidebar

| Item | What it does |
|------|-------------|
| 🏠 Dashboard | Your home screen — QC and Final Review hero cards |
| 📋 All Jobs | Full list of all jobs |
| 📝 My QC Queue | Your personal assigned QC tasks |
| 🔎 Reviewer Queue | Jobs submitted by Linguists awaiting your second-pass review |
| 🔍 QC Review | Organisation-wide QC queue |
| ✅ Final Review | Jobs awaiting final approval (with badge count) |
| 📖 Help | This guide |

After login you are automatically redirected to **My QC Queue**.

---

## 1. Your Dashboard

![Reviewer dashboard](/help-screenshots/reviewer/01-dashboard.png)

- **Quality Control** hero card (blue) — count of jobs in QC. **Left-click** **Go to QC Review** to open the full queue.
- **Final Approval** hero card (purple) — count of jobs in Final Review. **Left-click** **Go to Final Review** to open the queue.
- **KPI tiles** at the top: Total, Processing, In QC Review, Completed.

---

## 2. My QC Queue

Your personal queue of jobs directly assigned to you.

**Step 1.** In the sidebar, **left-click** **My QC Queue** (📝).

![My QC Queue](/help-screenshots/reviewer/02-qc-queue.png)

Use the **status tabs** at the top to filter: All, Pending, In Progress, Pending Review, In Review, Approved, Rejected.

**Left-click** **Open →** on any row to open that job's QC Detail page.

---

## 3. Reviewer Queue

The Reviewer Queue shows jobs that have been **submitted by Linguists** and are now waiting for your second-pass check.

**Step 1.** In the sidebar, **left-click** **Reviewer Queue** (🔎).

![Reviewer Queue](/help-screenshots/reviewer/03-reviewer-queue.png)

This queue is locked to your **reviewer role** — you see only jobs where you are the assigned reviewer and the status is "Pending Review" or "In Review".

**Left-click** **Open →** on any row to open that job.

---

## 4. Performing a QC Review

When you open a job from your queue, you land on the **QC Detail** page.

![QC Detail page — reviewer view](/help-screenshots/reviewer/04-qc-detail.png)

### Expanding a language

**Left-click** the language card header to expand it. You see:
- The **Linguist assignment** (who did the first-pass)
- The **VTT Editor** showing captions and/or audio descriptions
- The **Approval percentage bar** — tracks how many languages are approved vs total

### Reviewing VTT content

Scroll through the cues carefully. You can:
- **Read** all cues in read-only mode (default)
- **Edit** any cue as needed — same interface as the Linguist's editor (see Linguist Guide §4 for full editing instructions)

### Approving a language

When you are satisfied with a language:

**Left-click** **✓ Approve** (green button) on the language card.

![Approve button highlighted](/help-screenshots/reviewer/05-approve-button.png)

The language status changes to **Approved**. If all languages are now approved and there are no validation errors, the job will automatically advance to **Final Review**.

### Requesting changes

If you find issues:

**Step 1.** **Left-click** **✕ Request changes** (red button) on the language card.

![Request changes modal](/help-screenshots/reviewer/06-request-changes-modal.png)

**Step 2.** In the modal, **left-click** one or more **category buttons** to tag the type of issue:
- **Timing** — cue timing is wrong
- **Mistranslation** — translation is incorrect
- **Terminology** — wrong use of client terms or brand names
- **Profanity** — inappropriate language
- **Length** — cue too long or too short
- **Other** — any other issue

**Step 3.** Type detailed feedback in the **Notes** textarea (required). Be specific — the Linguist will use this to make corrections.

**Step 4.** **Left-click** **Send feedback**. The job is returned to the Linguist with your notes. The status changes to **Rejected**.

To cancel without sending: **left-click** **Cancel** or press **Esc**.

---

## 5. Assigning Linguists and Reviewers

From the QC Detail page, you can assign or reassign team members to language slots.

### Assigning a single language

**Step 1.** Find the language card with "Unassigned" in the Linguist or Reviewer slot.

**Step 2.** **Left-click** **Assign** (or **Reassign** if someone is already assigned). The assignment modal opens.

![Assignment modal](/help-screenshots/reviewer/07-assign-modal.png)

**Step 3.** **Left-click** the person dropdown and select the team member.

> **Note:** If you assign a linguist who does not have the required language in their competencies, an **amber warning** appears. You can still assign them — it is a warning, not a block.

**Step 4.** Optionally set a **Deadline** date.

**Step 5.** **Left-click** **Assign** to confirm.

### Bulk assignment

To assign all unassigned languages at once:

**Step 1.** **Left-click** the **Bulk Assign** button (appears in the page header when languages are unassigned).

**Step 2.** In the modal, select a **Linguist** (required) and optionally a **Reviewer** and **Deadline**.

**Step 3.** Optionally check **Skip languages that already have a linguist assigned** to avoid overwriting existing assignments.

**Step 4.** **Left-click** **Assign N languages** to confirm.

---

## 6. The VTT Editor — Full Access

As a Reviewer, you have full edit rights in the VTT editor, same as a Linguist. See the **Linguist Guide § 4** for detailed instructions on editing cue text, timestamps, inserting, and deleting cues.

### Keyboard shortcuts (QC Detail page)

| Key | Action |
|-----|--------|
| `A` | Approve the currently selected language |
| `R` | Open the Request Changes modal |
| `Cmd/Ctrl + S` | Save the full VTT file |
| `1` | Switch to side-by-side view (editor + video) |
| `2` | Switch to video-only view |
| `3` | Switch to editor-only view |
| `Esc` | Close modal / cancel edit |

---

## 7. Adjusting Timing Offsets

If the entire captions track is shifted (e.g. all cues are 2 seconds early), you can apply a **bulk timing offset** instead of adjusting each cue individually.

**Step 1.** On the QC Detail page, scroll to the **Timing Adjustment** section.

**Step 2.** **Left-click** it to expand.

**Step 3.** Enter the offset in seconds (positive = shift forward, negative = shift back).

**Step 4.** **Left-click** the checkboxes to apply to **Captions** and/or **Audio Description**.

**Step 5.** **Left-click** **Adjust** to apply.

---

## 8. Sharing a Preview Link

You can share a read-only preview link with a client or stakeholder.

**Step 1.** On the QC Detail page, **left-click** the **Share Link** button (top-right of page).

**Step 2.** Optionally type a label in the input field.

**Step 3.** **Left-click** **Generate**.

**Step 4.** **Left-click** **Copy** to copy the link to clipboard.

The link is valid for 30 days and does not require a login.

---

## 9. Final Review

When all languages of a job are approved in QC, the job moves to **Pending Final Review**. You perform the final quality gate.

### Viewing the Final Review queue

**Step 1.** In the sidebar, **left-click** **Final Review** (✅).

![Final Review queue](/help-screenshots/reviewer/08-final-list.png)

**Step 2.** **Left-click** any pending job to open its **Final Detail** page.

### The Final Detail page

![Final Detail page](/help-screenshots/reviewer/09-final-detail.png)

You see:
- **Asset Validation Summary** — green ✓ if all files are present and valid, red ✗ if something is missing.
- **Video Review Player** — play the accessible video with captions and audio description. **Left-click** a language in the player to switch.
- **Per-language asset cards** — each shows: translation type (Original / Transcreated / Translated), QA notes if any, VTT editor (read-only by default), audio player, asset readiness indicators.

### Approving or rejecting

**Step 1.** Review all languages thoroughly — watch the video, read the captions, listen to the audio description.

**Step 2.** Scroll to the **Final Review Decision** section.

**Step 3.** **Left-click** the radio button for your decision:
- **Approve for Client Delivery** — sends the job to Completed and notifies the client.
- **Return for Quality Control** — sends the job back to QC with your notes.

**Step 4.** If returning, type your notes in the **Review notes** textarea (required).

**Step 5.** **Left-click** **Confirm** to apply your decision.

![Final Review decision panel](/help-screenshots/reviewer/10-final-decision.png)

---

## 10. QC Review — Organisation-wide Queue

The **QC Review** page (`/admin/qc`) shows all jobs currently in QC for your organisation — not just the ones assigned to you.

**Left-click** **QC Review** (🔍) in the sidebar. You can browse all jobs, bulk-approve or bulk-reject using the checkboxes, and open any job.

### Bulk actions

**Step 1.** **Left-click** checkboxes next to jobs, or **left-click** **Select All**.

**Step 2.** In the **Actions** dropdown, **left-click** **Approve Selected** or **Reject Selected**.

**Step 3.** For rejection, type your notes in the input field.

**Step 4.** **Left-click** **Apply**.

---

## 11. Timeline Preview & Rendering

After editing cues or adjusting the AD script, the **Timeline Preview** bar shows the structure of the accessible video so you can verify the layout before triggering a render.

### Reading the Timeline bar

| Colour | Meaning |
|--------|---------|
| Blue | Video segment — no narration |
| Orange | AD Audio segment — narration plays here |
| Light orange | TTS cue queued for regeneration |
| Red line | Pause Point — video pauses to insert narration |
| Red tick | Pause Point that has been manually adjusted |

### Render Accessible Video Changes

The purple panel below the timeline becomes active when changes are pending:

| Message | What triggered it |
|---------|------------------|
| "N TTS cue(s) queued for regeneration" | Cues queued for TTS re-synthesis |
| "Pause points have been adjusted" | Pause points moved or added |
| "Audio Description script was replaced" | New AD VTT file uploaded |

**Run Whisper pause refinement** checkbox:
- **Tick it** when you changed the *number or position* of AD cues.
- **Leave unchecked** when you only adjusted pause timing manually.

**Step 1.** Review the Timeline bar — confirm orange segments cover the correct video spans.

**Step 2.** **Left-click Render Changes** (turns purple when there are pending changes).

**Step 3.** A **Rendering…** spinner appears. The page refreshes automatically when complete.

> **Note:** Text-only cue edits do not require a render and are saved immediately.

---

## 12. Mouse Interactions Reference

| Action | Where | What happens |
|--------|-------|--------------|
| **Left-click** **Open →** | Queue rows | Opens QC Detail for that language |
| **Left-click** language card header | QC Detail | Expands/collapses the language panel |
| **Left-click** **✓ Approve** | Language card | Approves that language |
| **Left-click** **✕ Request changes** | Language card | Opens feedback/rejection modal |
| **Left-click** feedback category | Rejection modal | Selects issue type (multi-select) |
| **Left-click** **Send feedback** | Rejection modal | Submits feedback to Linguist |
| **Left-click** **Assign/Reassign** | Language slot | Opens assignment modal |
| **Left-click** **Bulk Assign** | QC Detail header | Opens bulk assignment modal |
| **Left-click** job row | QC List / Final List | Opens that job |
| **Left-click** approval radio | Final Detail | Selects Approve or Return decision |
| **Left-click** **Confirm** | Final Detail decision | Applies the final review decision |
| **Left-click** **Share Link** | QC Detail | Opens share link generator |
| **Left-click** **Copy** | Share link modal | Copies link to clipboard |
| **Hover** over Linguist slot | Language card | Shows language competence tooltip |

---

## 13. Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `A` | Approve current language (QC Detail) |
| `R` | Open Request Changes modal (QC Detail) |
| `Cmd/Ctrl + S` | Save full VTT file |
| `1` / `2` / `3` | Switch view modes (side-by-side / video / editor) |
| `Esc` | Close modal / cancel edit |
| `Cmd/Ctrl + Enter` | Save cue text (in edit mode) |

---

## 14. Common Errors

| Error | Cause | Fix |
|-------|-------|-----|
| "Validation errors: N" badge | VTT has timing or format issues | Expand the errors list and fix each one before approving |
| Cannot approve | Validation errors still present | Fix all validation errors first |
| "Source language not approved" | English not yet approved | Approve English before approving translations |
| Job not in Final Review queue | Not all languages approved in QC | Check QC list — one language may still be Pending/In Progress |
| Asset validation failed | Missing VTT or MP3 file | Return to QC; Production may need to re-render |
