spec and document the 'url' setting