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.

docs(wiki): correct jobs, timeline and interviews help pages against the code; fix the delete-current-stage confirmation text

Khuram Niaz765fb937dca2
diff --git a/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx b/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
index b587c92..f6dcd42 100644
--- a/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
+++ b/src/components/myjobs/job-details/timeline/StageDetailPanel.tsx
@@ -62,8 +62,8 @@ export function StageDetailPanel({
<>
{isCurrent && (
<p>
- This is the current stage. Deleting it makes the stage before it
- current, and the job&apos;s status follows that stage.
+ This is the current stage. Deleting it makes the furthest-along
+ dated stage current, and the job&apos;s status follows that stage.
</p>
)}
{hasLinks && (
diff --git a/wiki/interviews.md b/wiki/interviews.md
index ddf9703..d8b2c89 100644
--- a/wiki/interviews.md
+++ b/wiki/interviews.md
@@ -15,7 +15,7 @@ stale_after: 2027-09-30
**Interviews** in the sidebar lists every interview round you have recorded, across every job, in one table. A round appears here as soon as you add a stage whose parent status is *Interview* on a job's [Timeline](./timeline.md) tab — there is nothing extra to fill in. Rounds on jobs that were rejected or withdrawn stay in the list, because the history is the point.
-Each row shows when the round is, the job and company, which round it is, the format and duration, who is interviewing you, how many prep questions the round has, and its outcome.
+Rounds are listed newest first, with rounds that have no date yet at the end. Each row shows when the round is, the job and company, which round it is, the format and duration, who is interviewing you, how many prep questions the round has, and its outcome.
## How do I find one interview among many?
diff --git a/wiki/jobs.md b/wiki/jobs.md
index 8b9b2c2..ce8c10b 100644
--- a/wiki/jobs.md
+++ b/wiki/jobs.md
@@ -33,11 +33,11 @@ A job's status now follows its [timeline](./timeline.md): it is whatever the job
## How do I change a job's status?
-There are two ways. In the Jobs list, click a row's status badge and pick the new status from the menu. Or open the job and use the **Update Status** button at the top-right of the job details, choosing **Change status**. Either menu lists every status with the current one greyed out, and the change saves immediately — there is no separate save step.
+There are three ways. In the Jobs list, click a row's status badge and pick the new status from the menu, or use the row's **⋮** menu and choose **Change status**. Or open the job and use the **Update Status** button at the top-right of the job details, choosing **Change status**. Every one of these menus lists every status with the current one greyed out, and the change saves immediately — there is no separate save step.
The Add Job dialog also has a Status field, so a status can be set when you first create the job or from **Edit Job** later.
-All three of those paths also append a stage to the job's [timeline](./timeline.md), so the history stays in step with the label. Picking a status the job already holds adds nothing.
+All four of those paths also append a stage to the job's [timeline](./timeline.md), so the history stays in step with the label. Picking a status the job already holds adds nothing.
## What is on a job's details page?
@@ -51,9 +51,11 @@ The tabs are **Description**, **[Timeline](./timeline.md)**, **AI Match**, **Cov
Notes live on the **Notes** tab: **New Note** there adds one, and each note can be edited or deleted from its own card. **Add a Note** in the **⋮** menu is a shortcut to the same thing from anywhere on the page — it switches to the Notes tab and opens the editor.
+You can also act from the Jobs list without opening the job: each row has **Edit** and **Delete** icons, and its **⋮** menu has **View Details** and **Add a Note**.
+
## How do I find a job in a long list?
-The Jobs card header has three tools. The **search box** matches on job text. The **filter dropdown** narrows to a preset: All (Except Dismissed), Applied, Interview, Draft, Rejected, Part-time, Accepted (discovered) or Dismissed (discovered). Clicking a company, title, location or source anywhere in the list adds it as a filter chip next to the search box — click the chip's **×** to clear it.
+The Jobs card header has three tools. The **search box** matches on job text. The **filter dropdown** narrows to a preset: All (Except Dismissed), Applied, Interview, Draft, Rejected, Part-time, Accepted (discovered) or Dismissed (discovered). Opening the list from a job count in **Library → Companies**, **Job Titles**, **Locations** or **Sources** narrows it to that entry and shows it as a filter chip next to the search box — click the chip's **×** to clear it.
The list also has a view toggle for table or card layout, and a reload button that refetches without a full page refresh.
diff --git a/wiki/timeline.md b/wiki/timeline.md
index d535588..3a9c754 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. 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.
+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 anything not reached yet — a stage after the current one, or the greyed **Offer** step at the end. 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.
@@ -33,13 +33,13 @@ Editing a stage later opens the same dialog with one extra field, **Outcome**: *
Select the stage, then use the **bin button** at the top right of its detail panel, beside **Edit**. You are asked to confirm, and the stage goes along with its notes, its interviewer links and its prep list — the contacts and questions themselves stay in your Library.
-Deleting the **current** stage moves the job back to the stage before it, and the job's status follows that stage; the confirmation says so. Deleting the last stage a job has leaves it with no timeline at all, which is a supported state — the job simply keeps the status it had.
+Deleting the **current** stage makes the furthest-along dated stage current, and the job's status follows it; the confirmation says so. Deleting the last stage a job has leaves it with no timeline at all, which is a supported state — the job simply keeps the status it had.
## How does a stage change the job's status?
The current stage sets the job's status: whatever parent status that stage's type carries becomes the job's status, everywhere the job is shown. Adding a stage with **Set as current stage** ticked moves the status; ticking the box on an older stage moves it back.
-It works the other way round too. Changing the status from **Update Status → Change status**, from a row's status badge in the Jobs list, or from the Status field in the **Edit Job** dialog appends a new stage for that status and makes it current — so a status change never leaves the timeline behind. The appended stage is dated the moment you made the change; open it from the Timeline tab and edit the date if the step actually happened earlier.
+It works the other way round too. Changing the status from **Update Status → Change status**, from a row's status badge or **⋮ → Change status** in the Jobs list, or from the Status field in the **Edit Job** dialog appends a new stage for that status and makes it current — so a status change never leaves the timeline behind. The appended stage is dated the moment you made the change; open it from the Timeline tab and edit the date if the step actually happened earlier.
Re-picking a status the job already holds does nothing at all. If the current stage is *2nd Technical Interview* and you pick **Interview** from a dropdown, you already are at Interview, so no second stage is added.
@@ -51,13 +51,13 @@ So a job added long after you applied can show its New stage dated after its App
## Why does a stage show a dash instead of a date?
-Because that stage has no date, which is allowed. Dates are optional on every stage: a stage appended by a status change never has one, and neither does a stage you added without filling the Date field.
+Because that stage has no date, which is allowed. Dates are optional on every stage: a stage you added without filling the Date field has none.
An undated stage reads `—` in the Stage History list, and **No date set** in its detail panel. Among stages of the same type it sorts to the end rather than to the start. Open the stage and use **Edit** to add the date whenever you learn it.
## How do I record who is interviewing me?
-Select the interview stage, then use **Add** on its **Interviewer** tab, or **Update Status → Add 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. Each shows their title and company under their name.
+Select the interview stage, then use **Add Interviewers** on its **Interviewer** tab, or **Update Status → Add Interviewers**. The dialog searches your existing [contacts](./contacts.md); the **Add a new contact** box at the bottom takes a name, job title and email and creates the person on the spot. Each shows their title and company under their name.
Linking someone also adds them to the job's **Contacts** tab with the **Interviewer** role, so that tab stays the 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.