Add a doc on pod states

@brendanburns @bgrant0607 @lavalamp @dchen1107 
Also includes time before being scheduled.