wrote documentation for new action paradigm