Add a description of pod states in kubernetes.

Closes #1146 
"When one gets or lists..."