# Frequently Asked Questions

## How do I re-trigger accessible video rendering?

Go to the **QC Review** page for the job (`/admin/qc/<job-id>`).

1. Switch to the **Accessible Video** tab (the orange tab labelled "Accessible Video").
2. Make any edit — adjust a pause point by dragging it on the timeline, edit the AD script in the VTT editor, or change TTS voice settings.
3. A yellow banner **"Render Changes"** appears at the top of the timeline. Click it.
4. The worker picks up the re-render request. The video status changes to **Rendering QC** and the timeline refreshes when done.

> If no edits have been made but you still need to force a re-render, make a trivial change to a pause point (move it by 1 ms and move it back) — this marks the job as stale and enables the Render Changes button.

**Who can do this:** Reviewer, Production, Admin.

---

## A job is stuck — how do I restart it?

Go to **Admin → Failures** (`/admin/failures`).

- If the job appears there: tick its checkbox and click **Retry selected** → choose **Auto** (retries from the failed step) or **From scratch** (full re-ingest).
- If it doesn't appear there: open the job detail, check the status badge. If it shows `processing_failed`, the Failures page should list it. If it shows a different stuck status (e.g. `ai_processing` for over 30 min), escalate to Production or Admin.

**Who can do this:** Production, Admin.

---

## How do I assign a linguist or reviewer to a language?

Open the job in **QC Review** (`/admin/qc/<job-id>`).

1. Find the language row in the **Languages** panel on the right.
2. Click the **Assign** button next to the language.
3. Select the user from the dropdown (includes linguist, admin, and production roles).
4. Optionally set a deadline.
5. Click **Assign**.

The assigned user appears in their **Linguist Queue** (`/qc/queue`) immediately.

**Who can do this:** Reviewer, Production, Admin.

---

## How do I download the final outputs?

**Clients:** Go to **Jobs** → open the job → click **Download**. Links are valid for 24 hours.

**Production / Admin:** Open the job detail → scroll to the **Downloads** section → click the format you need. You can also use the **Final Review** page (`/admin/final`) to download all languages at once.

> Signed download URLs expire after 24 hours. Refresh the page to get a new link if yours has expired.

---

## How do I add a new language to an existing job?

New languages cannot be added to a job after it has been submitted. Create a new job with the additional languages, or contact the Production team to re-process the original job.

---

## Captions are timed wrong in the accessible video — what do I do?

The accessible video uses **retimed captions** that shift forward to account for inserted pause segments. If they look wrong:

1. Open QC Review → Accessible Video tab.
2. Check the timeline — orange freeze blocks are the pause insertions.
3. Adjust any pause points that are incorrectly placed (drag on the timeline or use the editor popover).
4. Click **Render Changes** to re-render with corrected timings.

If captions are consistently off by a fixed amount, use **Adjust Timing** on the VTT editor (clock icon) to shift the source captions, then re-render.

---

## How do I change the TTS voice for a job?

Open the job in **QC Review** → scroll to the **TTS Preferences** panel (below the VTT editors).

- Change the provider (Gemini / Google / ElevenLabs), voice, speed, or style.
- Click **Save Preferences**.
- To apply the new voice to specific cues, right-click a pause-point marker on the timeline → **Regenerate TTS**.
- To re-render the full accessible video with the new voice, click **Render Changes**.

**Who can do this:** Production, Admin.

---

## How do I create a Job Brief?

Go to **Briefs** (`/briefs`) → click **New Brief**.

Fill in:
- **Title** — descriptive name for the job batch
- **Project** — optional, links the brief to a client project
- **Assign To** — optional PM, Admin, or Production user who will action it
- **Requested Outputs** — tick which deliverables are needed
- **Languages** — select target languages
- **Deadline** — optional

Click **Create Brief**. The brief appears in the Briefs list where the assigned person can action it.

**Who can do this:** Client, Project Manager, Production, Admin.

---

## What do the job status colours mean?

| Colour | Status | Meaning |
|--------|--------|---------|
| Grey | Created | Uploaded, not yet processing |
| Blue | Ingesting / AI Processing | Pipeline running |
| Yellow | Pending QC | Awaiting linguist or reviewer |
| Orange | QC Feedback | Sent back for changes |
| Purple | Translating / TTS / Rendering | Post-QC pipeline running |
| Green | Completed | All outputs delivered |
| Red | Rejected / Failed | Needs attention |

---

## Who do I contact for access or role changes?

Contact your **Admin** user or the Production team. Admins can change roles, invite new users, and manage organisation memberships from **Admin → Users** or **Org Settings**.
