clarity around documentation to use url