feat(docs): Add some basic API documents.

@zaach, @6a68, @nchapman - could I get a review of these? I'm adding @6a68 and @nchapman because they need some docs NOW.
> The promise will not resolve if the user is redirected to Firefox Accounts.

It might be helpful to explain that this is expected behavior in the redirect flow rather than something amiss.