Missing description for job status

[franra9]

Dear AS developers,

After some time looking at the documentation looking for the meaning of a specific job status, I realised that there is no (or I was unable to see a) place where the meaning of the different job status is described.

I only found the list of possible STATUS:

{READY,COMPLETED,WAITING,SUSPENDED,FAILED,UNKNOWN,QUEUING,RUNNING,HELD}

Some are obvious, such as COMPLETED, FAILED, QUEUING,... but others are not clear for me from just the name of the status (SUSPENDED vs HELD?)

I think a table like this would be very useful:

JOB STATUS	MEANING
COMPLETED	job successful
FAILED	job not run successfully
...	...

Thanks in advance!
Best,

Francesc