Add a description of pod states in kubernetes.

Closes #1146 
May help to clarify how this is different than PodSuccess (I think I understand what you mean that it may trail the real state, but it's not clear when something would be PodRunning vs. PodSuccess)