add documentation for the movement events