docs: Update docs around authentication to make them clearer where the route goes, and where the token is returned

docs: Update docs around authentication to make them clearer where the route goes, and where the token is returned #915