Improve auth docs

Created by: beyang

Fixes https://github.com/sourcegraph/sourcegraph/issues/1859. Merge after https://github.com/sourcegraph/sourcegraph/pull/1923