Add a description of pod states in kubernetes.

Closes #1146