PFM-1008 [API] Document goal states.

The meaning of the statuses doesn't quite seem to match up with the status names themselves, but that is actually what they mean.