It would be great to hyperlink references to algorithms like IteratorBindingInitialization about es-spec-html HOT 6 OPEN

Where would the link go to? There are 2 sections that define IteratorBindingInitialization: 14.1.18 and 14.2.14. (In general, an operation that is 'sub-defined' based on grammar productions is defined over multiple non-contiguous sections.)

For a while, the draft spec had an annex that listed such operations, and the sections where they were defined. That would have provided a plausible endpoint for such a hyperlink.

from es-spec-html.

I know :( --- Like I said, "it would be easier..." but I think it could be possible to special case some of them in the mean time

Maybe @allenwb would be willing to make some adjustments to the document to be specific about which version is being referred to

from es-spec-html.

It sounds like you're assuming that an invocation of such an operation will only 'resolve' to one sub-definition in practice. (And so, if the spec could just hint which one that was, the hyperlink could go to it.)

But in general, that's not the case. For instance, in the example you cite, in FunctionDeclarationInstantiation, the calls to IteratorBindingInitialization will sometimes resolve to a sub-definition in 14.1.18, and sometimes to a sub-definition in 14.2.14. So it's not like the spec can provide more specific info that would allow you to link to just one or the other.

from es-spec-html.

awbjs covered that point on the bug. I think it's bogus, since each listing for these algorithms contains numerous separate algorithms anyways, depending on the grammar it's operating on.

But regardless, it should be able to show a list of each version, with a short description (which would be easier if some metadata for each one were provided), and just generally save a lot of time when digging through the draft

from es-spec-html.

awbjs covered that point on the bug.

Specifically, https://bugs.ecmascript.org/show_bug.cgi?id=4275 (for anyone else reading this issue).

I think it's bogus, since each listing for these algorithms contains numerous separate algorithms anyways, depending on the grammar it's operating on.

I don't follow why that makes you think it's bogus.

But regardless, it should be able to show a list of each version, with a short description

So something like the annex I mentioned? Maybe AWB could be persuaded to reinstate it in the draft spec for ES7. But, yes, the HTML version of ES6 could conceivably generate something like that "on its own".

from es-spec-html.

I don't follow why that makes you think it's bogus.

Linking to 13.2.3.6 would still be linking to a polymorphic set of steps --- it's just that there are multiple sets of these polymorphic sets of steps (which is weird, but I guess that's useful for the paper edition)

from es-spec-html.