Added documentation for new state handling