add documentation on CM message states