27515 2014-12-04 14:07:56 +0000 Last changes breake external references 2015-06-02 11:21:23 +0000 1 1 1 Unclassified WHATWG URL unspecified All All RESOLVED WORKSFORME P2 normal Unsorted 1 crimsteam annevk annevk mike rubys sideshowbarker+urlspec oldest_to_newest 115920 0 crimsteam 2014-12-04 14:07:56 +0000 Hi, I see that last URL spec change a lot of ids, and potentialy may break some external references (like for MDN site). Of course no big deal and external references can always be corrected (if this form is more convenient for the URL specification). New solution looks better, I check this version: https://specs.webplatform.org/url/webspecs/develop/ But I noticed one strange change. Definitions for terms or algorithms now always use uppercase interface's name: get the base >> #concept-URLUtils-get-the-base update steps >> #concept-URLUtils-update input >> #concept-URLUtils-input url objects >> #concept-URLSearchParams-url-object etc. but all other things use always lowercase names and before change they were always lowercase (like urlutils or urlsearchparams). This applies to all interfaces. Other specifications always use lowercase names for interfaces. Maybe it's better to use a consistent convention? 115924 1 rubys 2014-12-04 15:12:58 +0000 Fixed by https://github.com/whatwg/url/commit/63d5f08b1ce359d980f20920818494df44a20989 116250 2 crimsteam 2014-12-13 02:15:13 +0000 Back to this bug from: https://www.w3.org/Bugs/Public/show_bug.cgi?id=27507#c5 So once again: Last URL spec (WHATWG) break refers around API (https://url.spec.whatwg.org/#api), especialy for "6.3. URLUtils and URLUtilsReadOnly members". Example of one that id: #dom-urlutils-href (now) #dom-url-href (before) and other ids for attributes or methods like protocol, username, password etc. (but not algos and concepts << this are the same)... So if other docs use them then aren't work now: https://developer.mozilla.org/en-US/docs/Web/API/URLUtils.href#Specifications https://developer.mozilla.org/en-US/docs/Web/API/URLUtils.host#Specifications https://developer.mozilla.org/en-US/docs/Web/API/URLUtils.port#Specifications But in my opinion this new wariant is better, all this stuff are definded for URLUtils and URLUtilsReadOnly, not for URL. And in this document https://specs.webplatform.org/url/webspecs/develop/ you use two nested <dfn>, one for URLUtils and one for URLUtilsReadOnly, and make it more clear: <dfn id="dom-urlutilsreadonly-href"> <dfn id="dom-urlutils-href"><code>href</code></dfn> </dfn> === But I caught another change; in IDL all ids for interface name have "dom-" prefix, so all old references break now: Fetch spec refer to URLSearchParams https://fetch.spec.whatwg.org/#bodyinit https://fetch.spec.whatwg.org/#concept-bodyinit-extract MDN https://developer.mozilla.org/en-US/docs/Web/API/URLUtils#Specifications https://developer.mozilla.org/en-US/docs/Web/API/URLUtilsReadOnly#Specifications In other specs from WHATWG (including HTML, and some W3C snapshots) this "dom-" prefix in IDL never exist. Old solution can be fast checked in this snapshot: http://w3ctag.github.io/url/ External references can always be corrected but Anne asked me to open bug for this. 116274 3 rubys 2014-12-14 00:30:03 +0000 First, sorry about this. I developed the conversion to bikeshed in a separate branch and tried not to integrate it until it was ready. Clearly it wasn't. I've opened an issue on bikeshed which will account for a number of these differences: https://github.com/tabatkins/bikeshed/issues/308 Once bikeshed has been updated, I'll circle back and try to address the remainder of these differences. 120241 4 annevk 2015-05-09 09:35:34 +0000 I think the issues from comment 2 are now resolved. Anything left Arkadiusz? 120653 5 crimsteam 2015-06-02 09:45:01 +0000 Probably correct links in MDN but this is job for people from Mozilla. Btw., what is the future of this spec? Now we have two documents, WHATWAG/W3C and Web Platform Specs which slightly differ (second use railroad diagrams for parser). It's a bit confusing, I don't know which version is more recent and more forward-looking. 120656 6 annevk 2015-06-02 11:20:34 +0000 The version at url.spec.whatwg.org is canonical.