Ecma262: Use cross-references for things like `[[Set]]` and `?`

Created on 14 Jun 2020  路  5Comments  路  Source: tc39/ecma262

It's surprising to me that these operations are not linkable. Especially ?, which is a not-immediately-obvious shorthand that's used throughout the spec.

Most helpful comment

The ? and ! prefixes, at least, are a learn-once thing

As someone who looks at the spec only occasionally, I can guarantee they aren't a learn-once thing. And even if they are a learn-once thing, finding their definitions isn't easy, which presents a barrier to learning what they do mean.

All 5 comments

The ? and ! prefixes, at least, are a learn-once thing; being able to quickly get from an invocation of an internet method to all the internal methods defined with that name in the spec, however, would save a ton of ongoing time and frustration.

For [[Set]] and friends, see https://github.com/tc39/ecmarkup/issues/116, though in the mean time we could just add dfns to the definitions. (Though that would make them italic, which is maybe undesirable.)

Well, the聽thing聽with ?聽and聽! is聽that they鈥檇聽have to聽be聽scoped to聽<emu鈥慳lg>, otherwise it could cause arbitrary聽? and聽! in聽the聽document to聽auto鈥憀ink, which聽we聽definitely聽don鈥檛聽want.

@ExE-Boss I'd expect it to only autolink ? or ! when followed by a space, and an abstract operation name, which should hopefully cover those edge cases.

The ? and ! prefixes, at least, are a learn-once thing

As someone who looks at the spec only occasionally, I can guarantee they aren't a learn-once thing. And even if they are a learn-once thing, finding their definitions isn't easy, which presents a barrier to learning what they do mean.

Was this page helpful?
0 / 5 - 0 ratings