Merge pull request #2221 from buildkite/stephanieatte-patch-1

Update defining_steps.md

pages/pipelines/defining_steps.md

@@ -114,7 +114,6 @@ When you run a pipeline, a build is created. The following diagram shows you how
 
 <%= image "build-states.png", alt: "Build state diagram" %>
 
-
 <%= render_markdown partial: 'pipelines/build_states' %>
 
 ## Job states
@@ -123,6 +122,31 @@ When you run a pipeline, a build is created. Each of the steps in the pipeline e
 
 <%= image "job-states.png", alt: "Job state diagram" %>
 
+Job state             | Description
+----------------------| -----------------------------------------
+`pending`             | The job has just been created and doesn't have a state yet.
+`waiting`             | The job is waiting on a wait step to finish.
+`waiting_failed`      | The job was in a `waiting` state when the build failed.
+`blocked`             | The job is waiting on a block step to finish.
+`blocked_failed`      | The job was in a `blocked` state when the build failed.
+`unblocked`           | This block job has been manually unblocked.
+`unblocked_failed`    | This block job was in an `unblocked` state when the build failed.
+`limiting`            | The job is waiting on a concurrency group check before becoming either `limited` or `scheduled`.
+`limited`             | The job is waiting for jobs with the same concurrency group to finish.
+`scheduled`           | The job is scheduled and waiting for an agent.
+`assigned`            | The job has been assigned to an agent, and it's waiting for it to accept.
+`accepted`            | The job was accepted by the agent, and now it's waiting to start running.
+`running`             | The job is running.
+`finished`            | The job has finished.
+`canceling`           | The job is currently canceling.
+`canceled`            | The job was canceled.
+`timing_out`          | The job is timing out for taking too long.
+`timed_out`           | The job timed out.
+`skipped`             | The job was skipped.
+`broken`              | The jobs configuration means that it can't be run.
+`expired`             | The job expired before it was started on an agent.
+{: class="two-column"}
+
 As well as the states shown in the diagram, the following progressions can occur:
 
 can progress to `skipped`  | can progress to `canceling` or `canceled`