[Gap]: Document the federated back end authentication flow

[jhrozek]

Likely depends on PR #233

We need to document the feature before considering it ready though.

[danbarr]

@jhrozek This issue's been around for a while; I think it's done?

[jhrozek]

oh sorry it is! closing!