docs & tests for motion