adding some documentation for run, run!, execute, and response