better error message + doc