Skip to content

Job application tracker and AI-powered job search assistant. Helps job seekers manage their search journey with AI resume review, job matching, task logging, and application analytics, all while keeping your data private.

feat(timeline): split the stage detail panel into Overview / Interviewer / Prep List tabs and turn the current-stage accents green

Khuram Niaz640dc17782aa
diff --git a/__tests__/StageDetailPanel.spec.tsx b/__tests__/StageDetailPanel.spec.tsx
index e1bb70a..65d2e77 100644
--- a/__tests__/StageDetailPanel.spec.tsx
+++ b/__tests__/StageDetailPanel.spec.tsx
@@ -82,34 +82,79 @@ describe("StageDetailPanel", () => {
expect(screen.getByText(/Sep 24, 2026 · 10:00 AM · 90 min/)).toBeInTheDocument();
});
- it("shows interviewers, format, location and the asked tally for an interview stage", () => {
+ // Overview is the landing tab, so format, location, duration and outcome are
+ // on screen without a click; interviewers and questions are one tab away.
+ it("opens on Overview with location, format, duration and outcome", () => {
render(
<StageDetailPanel stage={interviewStage} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
);
+ expect(screen.getByRole("tab", { name: "Overview" })).toHaveAttribute("data-state", "active");
+ expect(screen.getByText("Acme HQ, Bldg 3")).toBeInTheDocument();
+ expect(screen.getByText("On-site")).toBeInTheDocument();
+ expect(screen.getByText("90 min")).toBeInTheDocument();
+ expect(screen.getByText("Scheduled")).toBeInTheDocument();
+ expect(screen.queryByText("Priya Nair")).toBeNull();
+ });
+
+ it("shows the linked interviewers on the Interviewer tab", async () => {
+ render(
+ <StageDetailPanel stage={interviewStage} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
+ );
+
+ await userEvent.click(screen.getByRole("tab", { name: "Interviewer" }));
+
expect(screen.getByText("Priya Nair")).toBeInTheDocument();
- expect(screen.getByText(/On-site/)).toBeInTheDocument();
- expect(screen.getByText(/Acme HQ, Bldg 3/)).toBeInTheDocument();
- expect(screen.getByText("1 of 2 asked")).toBeInTheDocument();
+ expect(screen.getByText("VP Engineering")).toBeInTheDocument();
+ });
+
+ // The tally rides on the trigger, so the prep progress is readable from the
+ // Overview tab without opening the list.
+ it("carries the asked tally on the Prep List tab trigger", async () => {
+ render(
+ <StageDetailPanel stage={interviewStage} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
+ );
+
+ expect(screen.getByRole("tab", { name: /Prep List 1 of 2/ })).toBeInTheDocument();
+
+ await userEvent.click(screen.getByRole("tab", { name: /Prep List/ }));
+
expect(screen.getByText("System Design")).toBeInTheDocument();
});
- it("hides interviewers and the prep list on a non-interview stage", () => {
+ it("drops the tab row on a non-interview stage and shows the overview alone", () => {
render(
<StageDetailPanel stage={nonInterviewStage} isCurrent={false} onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
);
+ expect(screen.queryByRole("tablist")).toBeNull();
expect(screen.queryByText(/INTERVIEWERS/)).toBeNull();
expect(screen.queryByText(/PREP LIST/)).toBeNull();
// Notes are a live textarea, so this is a value, not page text.
expect(screen.getByLabelText("NOTES")).toHaveValue("Bring laptop");
});
+ // Nothing remounts when another stage is selected, so the tab has to be
+ // reset by hand or an interview tab survives onto a stage that has none.
+ it("returns to Overview when another stage is selected", async () => {
+ const { rerender } = render(
+ <StageDetailPanel stage={interviewStage} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
+ );
+
+ await userEvent.click(screen.getByRole("tab", { name: "Interviewer" }));
+ rerender(
+ <StageDetailPanel stage={{ ...interviewStage, id: "st9" }} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
+ );
+
+ expect(screen.getByRole("tab", { name: "Overview" })).toHaveAttribute("data-state", "active");
+ });
+
it("marks a question asked inline, with no dialog and no save step", async () => {
render(
<StageDetailPanel stage={interviewStage} isCurrent onEdit={noop} onLinkInterviewers={noop} onAddPrepQuestions={noop} onChanged={noop} />,
);
+ await userEvent.click(screen.getByRole("tab", { name: /Prep List/ }));
await userEvent.click(
screen.getByRole("checkbox", { name: /Tell me about a conflict with a teammate/ }),
);
diff --git a/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx b/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
index 43b150a..9576249 100644
--- a/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
+++ b/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
@@ -1,23 +1,25 @@
"use client";
-import { useState, useTransition } from "react";
-import { CalendarDays, Monitor, Pencil, Trash2, UserPlus, X } from "lucide-react";
-import { Badge } from "@/components/ui/badge";
+import { useEffect, useState, useTransition } from "react";
+import { CalendarDays, Pencil, Trash2 } from "lucide-react";
import { Button } from "@/components/ui/button";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "@/components/ui/tabs";
import { DeleteAlertDialog } from "@/components/DeleteAlertDialog";
import { toastActionResult } from "@/lib/toast";
-import {
- deleteJobStage,
- unlinkStageInterviewer,
-} from "@/actions/jobStage.actions";
-import { STAGE_OUTCOMES } from "@/lib/constants";
+import { deleteJobStage } from "@/actions/jobStage.actions";
import type { JobStage } from "@/models/jobStage.model";
import {
+ askedTally,
formatStageDateTime,
isInterviewStage,
- stageInitials,
} from "./stageDisplay";
+import { StageOverviewTab } from "./StageOverviewTab";
+import { StageInterviewersTab } from "./StageInterviewersTab";
import { StagePrepList } from "./StagePrepList";
-import { StageNotes } from "./StageNotes";
+
+// Underline tabs rather than the app's filled pills: this row sits inside the
+// job's own pill tab bar, and two nested pill bars read as competing controls.
+const TAB_TRIGGER =
+ "cursor-pointer rounded-none border-b-2 border-transparent px-0 pb-2.5 text-sm font-semibold text-muted-foreground data-[state=active]:border-primary data-[state=active]:bg-transparent data-[state=active]:text-primary data-[state=active]:shadow-none";
type StageDetailPanelProps = {
stage: JobStage;
@@ -38,18 +40,16 @@ export function StageDetailPanel({
}: StageDetailPanelProps) {
const [, startTransition] = useTransition();
const [deleteOpen, setDeleteOpen] = useState(false);
+ const [tab, setTab] = useState("overview");
const interview = isInterviewStage(stage);
- const outcomeLabel = STAGE_OUTCOMES.find((o) => o.value === stage.outcome)?.label;
+ const { asked, total } = askedTally(stage);
- const unlink = (linkId: string) => {
- startTransition(async () => {
- const res = await unlinkStageInterviewer(linkId);
- toastActionResult(res, {
- success: "Interviewer unlinked from this stage",
- onSuccess: onChanged,
- });
- });
- };
+ // Selecting another stage re-renders this component rather than remounting
+ // it, so the tab has to follow the id or an interview tab survives onto a
+ // stage that has none.
+ useEffect(() => {
+ setTab("overview");
+ }, [stage.id]);
const onDelete = () => {
setDeleteOpen(false);
@@ -68,7 +68,7 @@ export function StageDetailPanel({
<div className="flex flex-wrap items-center gap-2.5">
<h3 className="text-lg font-bold">{stage.StageType.label}</h3>
{isCurrent && (
- <span className="rounded-full bg-primary px-2 py-0.5 text-[11px] font-bold text-primary-foreground">
+ <span className="rounded-full bg-emerald-500 px-2 py-0.5 text-[11px] font-bold text-white dark:bg-emerald-400 dark:text-emerald-950">
CURRENT STAGE
</span>
)}
@@ -100,98 +100,51 @@ export function StageDetailPanel({
{formatStageDateTime(stage.occurredAt, stage.durationMins)}
</p>
- {interview && (
- <>
- <hr className="my-4" />
- <div className="grid gap-5 @lg/timeline:grid-cols-2">
- <div>
- <div className="flex items-center justify-between gap-2">
- <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
- INTERVIEWERS
+ {/* A one-tab bar is a control that does nothing, so a non-interview
+ stage gets the overview on its own. */}
+ {interview ? (
+ <Tabs value={tab} onValueChange={setTab} className="mt-4">
+ <TabsList className="h-auto w-full justify-start gap-6 rounded-none border-b bg-transparent p-0">
+ <TabsTrigger value="overview" className={TAB_TRIGGER}>
+ Overview
+ </TabsTrigger>
+ <TabsTrigger value="interviewer" className={TAB_TRIGGER}>
+ Interviewer
+ </TabsTrigger>
+ <TabsTrigger value="prep" className={TAB_TRIGGER}>
+ Prep List
+ {total > 0 && (
+ <span className="ml-2 rounded-full bg-emerald-500/15 px-2 py-0.5 text-[11px] font-bold text-emerald-700 dark:text-emerald-300">
+ {asked} of {total}
</span>
- <Button
- variant="ghost"
- size="sm"
- className="h-6 cursor-pointer gap-1 px-2 text-xs"
- onClick={onLinkInterviewers}
- >
- <UserPlus className="h-3 w-3" />
- Link
- </Button>
- </div>
- {stage.interviewers.length === 0 ? (
- <p className="mt-2 text-sm text-muted-foreground">
- No interviewers linked yet.
- </p>
- ) : (
- <ul className="mt-2 space-y-2">
- {stage.interviewers.map((link) => (
- <li key={link.id} className="flex items-center gap-2.5">
- <span className="flex h-8 w-8 shrink-0 items-center justify-center rounded-full bg-primary text-[13px] font-bold text-primary-foreground">
- {stageInitials(link.Contact.name)}
- </span>
- <span className="min-w-0 flex-1">
- <span className="block truncate text-sm font-bold">
- {link.Contact.name}
- </span>
- {link.Contact.title && (
- <span className="block truncate text-xs text-muted-foreground">
- {link.Contact.title}
- </span>
- )}
- </span>
- <Button
- variant="ghost"
- size="icon"
- className="h-7 w-7 cursor-pointer"
- aria-label={`Unlink ${link.Contact.name}`}
- onClick={() => unlink(link.id)}
- >
- <X className="h-3.5 w-3.5" />
- </Button>
- </li>
- ))}
- </ul>
)}
- </div>
-
- <div>
- <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
- FORMAT
- </span>
- <p className="mt-2 flex items-center gap-2 text-sm">
- <Monitor className="h-3.5 w-3.5 shrink-0" />
- {[stage.format, stage.location].filter(Boolean).join(" · ") || "Not set"}
- </p>
- </div>
- </div>
-
+ </TabsTrigger>
+ </TabsList>
+ <TabsContent value="overview" className="mt-4">
+ <StageOverviewTab stage={stage} onChanged={onChanged} />
+ </TabsContent>
+ <TabsContent value="interviewer" className="mt-4">
+ <StageInterviewersTab
+ stage={stage}
+ onLinkInterviewers={onLinkInterviewers}
+ onChanged={onChanged}
+ />
+ </TabsContent>
+ <TabsContent value="prep" className="mt-4">
+ <StagePrepList
+ stage={stage}
+ onAddPrepQuestions={onAddPrepQuestions}
+ onChanged={onChanged}
+ />
+ </TabsContent>
+ </Tabs>
+ ) : (
+ <>
<hr className="my-4" />
- <StagePrepList
- stage={stage}
- onAddPrepQuestions={onAddPrepQuestions}
- onChanged={onChanged}
- />
+ <StageOverviewTab stage={stage} onChanged={onChanged} />
</>
)}
- <hr className="my-4" />
- <div className="space-y-3">
- <div>
- <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
- OUTCOME
- </span>
- <p className="mt-1.5 text-sm">
- {outcomeLabel ? (
- <Badge variant="secondary">{outcomeLabel}</Badge>
- ) : (
- <span className="text-muted-foreground">Not recorded</span>
- )}
- </p>
- </div>
- <StageNotes stage={stage} onChanged={onChanged} />
- </div>
-
<DeleteAlertDialog
pageTitle="stage"
open={deleteOpen}
diff --git a/src/components/myjobs/job-details/timeline/StageHistoryList.tsx b/src/components/myjobs/job-details/timeline/StageHistoryList.tsx
index aa796a4..d6b4b5f 100644
--- a/src/components/myjobs/job-details/timeline/StageHistoryList.tsx
+++ b/src/components/myjobs/job-details/timeline/StageHistoryList.tsx
@@ -31,7 +31,7 @@ function StageMarker({
className={cn(
"flex h-5 w-5 items-center justify-center rounded-full",
state === "current"
- ? "bg-primary ring-4 ring-primary/20"
+ ? "bg-emerald-500 ring-4 ring-emerald-500/20 dark:bg-emerald-400 dark:ring-emerald-400/20"
: state === "complete"
? "bg-emerald-500 dark:bg-emerald-400"
: "border-2 border-border bg-card",
@@ -96,7 +96,7 @@ export function StageHistoryList({
<span
className={cn(
"flex-1 truncate text-[13px] font-semibold",
- isCurrent && "font-extrabold text-primary",
+ isCurrent && "font-extrabold text-emerald-600 dark:text-emerald-400",
)}
>
{stage.StageType.label}
@@ -104,7 +104,9 @@ export function StageHistoryList({
<span
className={cn(
"text-xs",
- isCurrent ? "font-bold text-primary" : "text-muted-foreground",
+ isCurrent
+ ? "font-bold text-emerald-600 dark:text-emerald-400"
+ : "text-muted-foreground",
)}
>
{formatStageDate(stage.occurredAt)}
diff --git a/src/components/myjobs/job-details/timeline/StageInterviewersTab.tsx b/src/components/myjobs/job-details/timeline/StageInterviewersTab.tsx
new file mode 100644
index 0000000..b02e602
--- /dev/null
+++ b/src/components/myjobs/job-details/timeline/StageInterviewersTab.tsx
@@ -0,0 +1,86 @@
+"use client";
+import { useTransition } from "react";
+import { UserPlus, X } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { toastActionResult } from "@/lib/toast";
+import { unlinkStageInterviewer } from "@/actions/jobStage.actions";
+import type { JobStage } from "@/models/jobStage.model";
+import { stageInitials } from "./stageDisplay";
+
+type StageInterviewersTabProps = {
+ stage: JobStage;
+ onLinkInterviewers: () => void;
+ onChanged: () => void;
+};
+
+export function StageInterviewersTab({
+ stage,
+ onLinkInterviewers,
+ onChanged,
+}: StageInterviewersTabProps) {
+ const [, startTransition] = useTransition();
+
+ const unlink = (linkId: string) => {
+ startTransition(async () => {
+ const res = await unlinkStageInterviewer(linkId);
+ toastActionResult(res, {
+ success: "Interviewer unlinked from this stage",
+ onSuccess: onChanged,
+ });
+ });
+ };
+
+ return (
+ <div>
+ <div className="flex items-center justify-between gap-2">
+ <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
+ INTERVIEWERS
+ </span>
+ <Button
+ variant="outline"
+ size="sm"
+ className="h-7 cursor-pointer gap-1"
+ onClick={onLinkInterviewers}
+ >
+ <UserPlus className="h-3 w-3" />
+ Link
+ </Button>
+ </div>
+
+ {stage.interviewers.length === 0 ? (
+ <p className="mt-2.5 rounded-lg border border-dashed p-4 text-center text-sm text-muted-foreground">
+ No interviewers linked yet.
+ </p>
+ ) : (
+ <ul className="mt-2.5 space-y-2">
+ {stage.interviewers.map((link) => (
+ <li key={link.id} className="flex items-center gap-2.5">
+ <span className="flex h-8 w-8 shrink-0 items-center justify-center rounded-full bg-primary text-[13px] font-bold text-primary-foreground">
+ {stageInitials(link.Contact.name)}
+ </span>
+ <span className="min-w-0 flex-1">
+ <span className="block truncate text-sm font-bold">
+ {link.Contact.name}
+ </span>
+ {link.Contact.title && (
+ <span className="block truncate text-xs text-muted-foreground">
+ {link.Contact.title}
+ </span>
+ )}
+ </span>
+ <Button
+ variant="ghost"
+ size="icon"
+ className="h-7 w-7 cursor-pointer"
+ aria-label={`Unlink ${link.Contact.name}`}
+ onClick={() => unlink(link.id)}
+ >
+ <X className="h-3.5 w-3.5" />
+ </Button>
+ </li>
+ ))}
+ </ul>
+ )}
+ </div>
+ );
+}
diff --git a/src/components/myjobs/job-details/timeline/StageOverviewTab.tsx b/src/components/myjobs/job-details/timeline/StageOverviewTab.tsx
new file mode 100644
index 0000000..1bc020c
--- /dev/null
+++ b/src/components/myjobs/job-details/timeline/StageOverviewTab.tsx
@@ -0,0 +1,69 @@
+"use client";
+import { Clock, MapPin, Monitor } from "lucide-react";
+import type { LucideIcon } from "lucide-react";
+import { Badge } from "@/components/ui/badge";
+import { STAGE_OUTCOMES } from "@/lib/constants";
+import type { JobStage } from "@/models/jobStage.model";
+import { StageNotes } from "./StageNotes";
+
+type StageOverviewTabProps = {
+ stage: JobStage;
+ onChanged: () => void;
+};
+
+function StageFact({
+ label,
+ value,
+ icon: Icon,
+}: {
+ label: string;
+ value: string | null;
+ icon: LucideIcon;
+}) {
+ return (
+ <div>
+ <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
+ {label}
+ </span>
+ <p className="mt-1.5 flex items-center gap-2 text-sm">
+ <Icon className="h-3.5 w-3.5 shrink-0 text-muted-foreground" />
+ {value ?? <span className="text-muted-foreground">Not set</span>}
+ </p>
+ </div>
+ );
+}
+
+export function StageOverviewTab({ stage, onChanged }: StageOverviewTabProps) {
+ const outcomeLabel = STAGE_OUTCOMES.find(
+ (o) => o.value === stage.outcome,
+ )?.label;
+
+ return (
+ <div className="space-y-4">
+ <div>
+ <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
+ OUTCOME
+ </span>
+ <p className="mt-1.5 text-sm">
+ {outcomeLabel ? (
+ <Badge variant="secondary">{outcomeLabel}</Badge>
+ ) : (
+ <span className="text-muted-foreground">Not recorded</span>
+ )}
+ </p>
+ </div>
+
+ <div className="grid gap-4 @lg/timeline:grid-cols-3">
+ <StageFact label="LOCATION" value={stage.location} icon={MapPin} />
+ <StageFact label="FORMAT" value={stage.format} icon={Monitor} />
+ <StageFact
+ label="DURATION"
+ value={stage.durationMins ? `${stage.durationMins} min` : null}
+ icon={Clock}
+ />
+ </div>
+
+ <StageNotes stage={stage} onChanged={onChanged} />
+ </div>
+ );
+}
diff --git a/src/components/myjobs/job-details/timeline/StagePrepList.tsx b/src/components/myjobs/job-details/timeline/StagePrepList.tsx
index 9750a01..9346472 100644
--- a/src/components/myjobs/job-details/timeline/StagePrepList.tsx
+++ b/src/components/myjobs/job-details/timeline/StagePrepList.tsx
@@ -28,7 +28,7 @@ export function StagePrepList({
// makes it durable.
const [pending, setPending] = useState<Record<string, boolean>>({});
const rows = stage.prepQuestions ?? [];
- const { asked, total } = askedTally(stage);
+ const { total } = askedTally(stage);
const toggle = (linkId: string, next: boolean) => {
setPending((prev) => ({ ...prev, [linkId]: next }));
@@ -54,16 +54,9 @@ export function StagePrepList({
return (
<div>
<div className="flex flex-wrap items-center justify-between gap-2">
- <div className="flex items-center gap-2">
- <span className="text-[11px] font-bold tracking-wide text-muted-foreground">
- PREP LIST · INTERVIEW QUESTIONS · {total}
- </span>
- {total > 0 && (
- <span className="rounded-full bg-emerald-500/15 px-2 py-0.5 text-[11px] font-bold text-emerald-700 dark:text-emerald-300">
- {asked} of {total} asked
- </span>
- )}
- </div>
+ <p className="text-xs text-muted-foreground">
+ Check off a question once your interviewer actually asks it.
+ </p>
<Button
variant="outline"
size="sm"
@@ -74,9 +67,6 @@ export function StagePrepList({
Add to Prep List
</Button>
</div>
- <p className="mt-1 text-xs text-muted-foreground">
- Check off a question once your interviewer actually asks it.
- </p>
{total === 0 ? (
<p className="mt-2.5 rounded-lg border border-dashed p-4 text-center text-sm text-muted-foreground">
diff --git a/wiki/timeline.md b/wiki/timeline.md
index c7e4462..40220ee 100644
--- a/wiki/timeline.md
+++ b/wiki/timeline.md
@@ -15,7 +15,7 @@ stale_after: 2027-09-30
The **Timeline** tab on a job's details page is that job's record of how the hiring process actually moved — one entry per stage, each with its own date, notes and outcome. A job's [status](./jobs.md) is a single label saying where the job is *now*; the timeline is the history behind that label, and the status is derived from it.
-The tab shows two things. A **Stage History** list down the left walks every stage in the order set by **Library → Stages**, joined top to bottom by a connecting line: a green tick marks each stage already behind you, a filled marker the current one, and a hollow marker the greyed **Offer** step at the end if the job has not reached an offer yet. Clicking a stage opens its **detail panel** on the right, where you edit the stage, record its outcome, write notes, and — on an interview stage — see the interviewers and the prep list.
+The tab shows two things. A **Stage History** list down the left walks every stage in the order set by **Library → Stages**, joined top to bottom by a connecting line: a green tick marks each stage already behind you, a filled marker the current one, and a hollow marker the greyed **Offer** step at the end if the job has not reached an offer yet. Clicking a stage opens its **detail panel** on the right. An interview stage splits that panel into three tabs — **Overview**, **Interviewer** and **Prep List** — and opens on Overview; any other stage shows the overview on its own, with no tabs, because the other two have nothing to say about it.
A count badge on the tab tells you how many stages a job has. Every job created after this feature shipped starts with one.
@@ -27,7 +27,7 @@ Pick a **stage** from the list — *New*, *Draft*, *Applied*, *Interview*, *1st
**Date** and **Time** are optional, and **Notes** is free text. If the stage's parent status is *Interview*, three more fields appear: **Format**, **Duration** and **Location** — use Location for a meeting link as happily as for a street address. **Set as current stage** is ticked by default; leave it ticked when you are recording where the job is now, and untick it when you are backfilling something that already happened.
-Editing a stage later opens the same dialog with one extra field, **Outcome**: *Scheduled*, *Completed*, *Passed*, *Failed*, *No-show* or *Cancelled*.
+Editing a stage later opens the same dialog with one extra field, **Outcome**: *Scheduled*, *Completed*, *Passed*, *Failed*, *No-show* or *Cancelled*. Outcome, location, format and duration all read back on the stage's **Overview** tab, above the notes box.
## How do I delete a stage?
@@ -57,7 +57,7 @@ An undated stage reads `—` in the Stage History list, and **No date set** in i
## How do I record who is interviewing me?
-Select the interview stage, then use **Link** in its **Interviewers** panel, or **Update Status → Link Interviewers**. The dialog searches your existing [contacts](./contacts.md); the **Add a new contact** box at the bottom takes a name, role and email and creates the person on the spot.
+Select the interview stage, then use **Link** on its **Interviewer** tab, or **Update Status → Link Interviewers**. The dialog searches your existing [contacts](./contacts.md); the **Add a new contact** box at the bottom takes a name, role and email and creates the person on the spot.
Linking someone also adds them to the job's **Contacts** tab with the **Interviewer** role, so that tab stays the single roster of everyone involved in the application. The reverse is not true: the **✕** beside an interviewer unlinks them from *that stage only* and leaves the job contact link alone, because the person may hold other roles on the job.
@@ -65,7 +65,7 @@ The same person can be linked to several stages of the same job, and a contact y
## How do I build a prep list for an interview?
-Select the interview stage and use **Add to Prep List**, either the button on its prep-list panel or the item in the **Update Status** menu. The dialog lists your question bank with an instant search over it; tick as many questions as you like and add them in one go.
+Select the interview stage and use **Add to Prep List**, either the button on its **Prep List** tab or the item in the **Update Status** menu. The dialog lists your question bank with an instant search over it; tick as many questions as you like and add them in one go.
To add a question that is not in the bank yet, type it into the box at the bottom, optionally pick a **category**, and add it. It is saved to your question bank as well as to this stage's prep list, so every later job can reach it — the bank is shared, not per-job. A question added this way is banked with the placeholder answer `TBD`; fill in the real answer from the Questions page when you are ready.
@@ -73,7 +73,7 @@ A question can be on the prep lists of several stages at once, and **✕** besid
## What is the difference between a question on a prep list and one marked "asked"?
-A prep-list question is one you *expect*; the checkbox beside it records that it was *actually asked*. Tick it during or after the interview and it saves immediately — there is no separate save step — and the panel header keeps a running `2 of 5 asked` tally.
+A prep-list question is one you *expect*; the checkbox beside it records that it was *actually asked*. Tick it during or after the interview and it saves immediately — there is no separate save step — and the **Prep List** tab carries a running `2 of 5` tally, so you can read the progress without opening the tab.
The distinction is what makes the list useful afterwards: which of the questions you prepared for came up, and which did not. Marking a question asked never changes the question itself or its answer in your bank.