Modernize the documentation for BaseAuthBackend.
Review Request #9989 — Created May 31, 2018 and submitted
This fleshes out the documentation for
argument/return types and documenting the various flags/capabilities on
Some things have been left alone for now, as they're going to be removed
in a future change.
Viewed the docs, checking for build, reference, and spelling errors.