better diagnostucs for alias handling and root directory errors
improve docs
Merge remote-tracking branch 'origin/4.5.0' into 4.5.0