Clean-up of authentication related functionality

Some URL functionality was duplicated in two places and
Authentication.fs module was messy. Duplication removed and consolidated
to Authentication.fs and the internal mess removed.
Update to documentation with regard to authorization

The documentation is now also updated with regard to using explicit (URI
scheme) authorization.