unified and simplified dispatcher apis, improved documentation