changing a url creation method, updating documentation