more help docs; better error message if auth token unavailable