Update jobs docs in cli reference
@@ -5,6 +5,37 @@ If the experiment is running in a distributed way then it will have more than on
For distributed experiments, it is often difficult to follow the logs/resources of that experiments,
so the user might want to look at a specific job running in that experiment.
+## Getting job info
+
+To view the info of a specific job, you need to have the experiment sequence it belongs to, and the job sequence within that experiment.
+
+
+```bash
+$ polyaxon job -xp 3 -j 1 get
+
+Job resources:
+
+resource limits requests
+---------- -------- ----------
+cpu 2 1
+memory 200 100
+gpu 1 1
+
+Job info:
+
+--------------- --------------------
+sequence 1
+role master
+experiment_name root.quick-start.3
+last_status Succeeded
+created_at 2 hours ago
+updated_at 15 minutes ago
+started_at 2 hours ago
+finished_at 2 hours ago
+total_run 10m 40s
+--------------- --------------------
+```
+
## Tracking job logs
To view the logs of a specific job, you need to have the experiment sequence it belongs to, and the job sequence within that experiment.
@@ -29,9 +60,34 @@ polyaxon job -xp 3 -j 1 resources
This command will show the resources in real time for that job.
-## Information and statuses
+## Job statuses
+
+To view the chronological statuses of a specific job, you need to have the experiment sequence it belongs to, and the job sequence within that experiment.
+
+```bash
+$ polyaxon job -xp 3 -j 1 statuses
+
+Statuses for Job `1`.
+
+
+Navigation:
+
+----- -
+count 6
+----- -
+
+Statuses:
+
+created_at status message
+------------ --------- ----------------------
+2 hours ago Created
+2 hours ago Building
+2 hours ago UNKNOWN Unknown pod conditions
+2 hours ago Building ContainerCreating
+2 hours ago Running
+2 hours ago Succeeded Completed
+```
-You can also get the information about the job and its statuses chronologically.
!!! info "More details"
For more details about this command please run `polyaxon job --help`,
