docs: improve auth methods docs and make clear different types of auth available#1754

enriquegh wants to merge 1 commit intomainsourcegraph/docs:mainfrom

eg-auth-token-clarificationssourcegraph/docs:eg-auth-token-clarificationsCopy head branch name to clipboard