Add a description of pod states in kubernetes.

Closes #1146 
I think that's letting transitions sneak into the states. Imagine this wording:

PodFailed: A container exited with a non-zero status, and will not be restarted.

Anyway I think it's additionally weird that we make an overall status of some determination for pods with containers in different states, but that's a different issue.