Add a doc on pod states

@brendanburns @bgrant0607 @lavalamp @dchen1107