Add a description of pod states in kubernetes.

Closes #1146 
This is very confusing. IMO I shouldn't have to understand restart semantics to be able to see what state a pod is in?