url/baseUrl confusion

[XVincentX]

The URL property here is kind of confusing

https://github.com/stoplightio/types/blob/master/src/http.ts#L18

since it makes you think it's a full URL but there are no query Parameters. I suggest we find a better nomenclature for this part so that's clear and we do not get in trouble.

We've been confused couple of times while using this property in Request Maker

[marbemac]

Hmm - any suggestions? We could add an additional sentence to the comment indicating query params should go on the query property and not be included in the URL? This property was initially inspired by the axios request object: https://github.com/axios/axios#request-config.

[XVincentX]

@marbemac I would really follow the same convention of URIJS

Feels complete and will address the confusion forever and ever