diff --git a/web/project-website/content/usage/jobs-tasks-commands/_index.md b/web/project-website/content/usage/jobs-tasks-commands/_index.md
index f4255635..1d074b89 100644
--- a/web/project-website/content/usage/jobs-tasks-commands/_index.md
+++ b/web/project-website/content/usage/jobs-tasks-commands/_index.md
@@ -5,6 +5,25 @@ weight: 5
 
 TODO: write about the pipeline from job submission to command execution.
 
+## Job Statuses
+
+The following table shows the meaning of the different job statuses:
+
+| Status                    | Meaning | Possible next status |
+| ------------------------- | ------- | ----------- |
+| `under-construction`      | Preparing job for execution | `queued`, `active` |
+| `queued`                  | Ready to be assigned to available Workers | `active`, `canceled` |
+| `active`                  | Tasks assigned to Workers for execution | `completed`,  `canceled`, `failed` |
+| `completed`               | All tasks executed successfully | `queued` |
+| `failed`                  | Execution of one or more tasks failed after multiple retries by different Workers | `queued`, `canceled` |
+| `cancel-requested`        | Request for job cancellation raised by user | `canceled` |
+| `canceled`                | Canceled by the user, job terminated immediately on all Workers | `queued` |
+| `requeueing`              | Request for requeueing of job raised by user | `queued` |
+| `paused`                  | Not yet implemented | |
+
+NOTE : 
+- Requeueing a job when it is `completed`, i.e. when all its tasks are `completed`, will requeue all its tasks.
+- Requeueing a job when some of its tasks are not `completed` will requeue these tasks only. The `completed` tasks will not be requeued, and will remain at `completed` status.
 
 ## Task Statuses
 
@@ -12,8 +31,10 @@ The following table shows the meaning of the different task statuses:
 
 | Status        | Meaning | Possible next status |
 | ------------- | ------- | ----------- |
-| `queued`      | Ready to be worked on by a Worker | `active`, `canceled` |
-| `active`      | Assigned to a worker for execution | `completed`, `canceled`, `failed`, `soft-failed` |
-| `soft-failed` | Same as `queued`, but has been failed by a worker in an earlier execution | `completed`, `failed`, `canceled` |
-| `completed`   | Worker executed the task succesfully | `requeued` |
+| `queued`      | Ready to be assigned to an available Worker | `active`, `canceled` |
+| `active`      | Assigned to a Worker for execution | `completed`, `canceled`, `failed`, `soft-failed` |
+| `completed`   | Task executed succesfully | `queued` |
+| `soft-failed` | Same as `queued`, but has been failed by a Worker in an earlier execution | `queued`, `completed`, `failed`, `canceled` |
+| `failed`      | Execution failed after multiple retries by different Workers | `queued`, `canceled` |
+| `canceled`    | Canceled by the user, task terminated immediately | `queued` |
 | `paused`      | Not yet implemented | |