update documentation and dipatching