Add a description of pod states in kubernetes.

Closes #1146 
I'm ok w/ removing Stopped.  distinction was supposed to be API vs management system, but I'm not sure its necessary.