From ff4b222f23b7062142e13fa8abebd705af69898e Mon Sep 17 00:00:00 2001
From: Alex Dadgar <alex.dadgar@gmail.com>
Date: Thu, 16 Jun 2016 14:00:45 -0700
Subject: [PATCH] Update status docs

---
 .../source/docs/commands/status.html.md.erb   | 88 ++++++++++++++++---
 1 file changed, 75 insertions(+), 13 deletions(-)

diff --git a/website/source/docs/commands/status.html.md.erb b/website/source/docs/commands/status.html.md.erb
index e580d3e1b..a075ff935 100644
--- a/website/source/docs/commands/status.html.md.erb
+++ b/website/source/docs/commands/status.html.md.erb
@@ -30,8 +30,11 @@ the most useful status fields for each.
 
 ## Status Options
 
+* `-evals`: Display the evaluations associated with the job.
+
 * `-short`: Display short output. Used only when a single node is being queried.
   Drops verbose node allocation data from the output.
+
 * `-verbose`: Show full information.
 
 ## Examples
@@ -57,24 +60,83 @@ Type        = service
 Priority    = 3
 Datacenters = dc1,dc2,dc3
 Status      = pending
+Periodic    = false
 ```
 
 Full status information of a job:
 
 ```
-$ nomad status job1
-ID          = job1
-Name        = Test Job
+$ nomad status example
+ID          = example
+Name        = example
 Type        = service
-Priority    = 3
-Datacenters = dc1,dc2,dc3
-Status      = pending
+Priority    = 50
+Datacenters = dc1
+Status      = running
+Periodic    = false
 
-### Evaluations
-ID        Priority  Type     TriggeredBy   NodeID  Status
-193229c4  3         service  job-register  node2   complete
-
-### Allocations
-ID        EvalID    NodeID  TaskGroup  DesiredStatus  ClientStatus
-678c51dc  193229c4  node2   grp8       failed         failed
+Allocations
+ID        Eval ID   Node ID   Task Group  Desired  Status
+24cfd201  81efc2fa  8d0331e9  cache       run      running
+```
+
+Full status information of a job with placement failures:
+
+```
+$ nomad status example
+ID          = example
+Name        = example
+Type        = service
+Priority    = 50
+Datacenters = dc1
+Status      = running
+Periodic    = false
+
+Placement Failure
+Task Group "cache":
+  * Resources exhausted on 1 nodes
+  * Dimension "cpu exhausted" exhausted on 1 nodes
+
+Allocations
+ID        Eval ID   Node ID   Task Group  Desired  Status
+0b8b9e37  8bf94335  8d0331e9  cache       run      running
+b206088c  8bf94335  8d0331e9  cache       run      running
+b82f58b6  8bf94335  8d0331e9  cache       run      running
+ed3665f5  8bf94335  8d0331e9  cache       run      running
+24cfd201  8bf94335  8d0331e9  cache       run      running
+```
+
+Full status information showing evaluations with a placement failure. The in
+progress evaluation denotes that Nomad is blocked waiting for resources to
+become availables so that it can place the remaining allocations.
+
+```
+$ nomad status -evals example
+ID          = example
+Name        = example
+Type        = service
+Priority    = 50
+Datacenters = dc1
+Status      = running
+Periodic    = false
+
+Evaluations
+ID        Priority  Triggered By  Status    Placement Failures
+69f34a37  50        job-register  blocked   N/A - In Progress
+8bf94335  50        job-register  complete  true
+df79bec7  50        job-register  complete  false
+81efc2fa  50        job-register  complete  false
+
+Placement Failure
+Task Group "cache":
+  * Resources exhausted on 1 nodes
+  * Dimension "cpu exhausted" exhausted on 1 nodes
+
+Allocations
+ID        Eval ID   Node ID   Task Group  Desired  Status
+0b8b9e37  8bf94335  8d0331e9  cache       run      running
+b206088c  8bf94335  8d0331e9  cache       run      running
+b82f58b6  8bf94335  8d0331e9  cache       run      running
+ed3665f5  8bf94335  8d0331e9  cache       run      running
+24cfd201  8bf94335  8d0331e9  cache       run      running
 ```