dispatch is required (call to error()), updated docs