[Enhancement] Update documentation for synchronous / callback / promise style implementation of the authorization handler

[colceagus]

The authHandler now is agnostic of the synchronous / callback / promise implementation styles.
Documentation only provides examples for the synchronous parts. Make visible the fact that the handler can be implemented using a promise or a callback.