Improved/corrected url parsing utils and documentation

Improvement of documentation and utilities for handling a harmonized "nomad url" concept. Part of the work with #828 (closed).