Add a description of pod states in kubernetes.

Closes #1146 
@dchen1107 Let's not go into timeouts, etc. here.