This fleshes out the documentation for BaseAuthBackend, clarifying

argument/return types and documenting the various flags/capabilities on

the class.
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.