generalized 'authed' and improved documentation