added url creation helper methods, updated readme with better description