improve docstrings, fix some errors normalize on_error and on_result