updated error message & docs