{"action":"created","issue":{"url":"https://api.github.com/repos/tc39/test262/issues/477","labels_url":"https://api.github.com/repos/tc39/test262/issues/477/labels{/name}","comments_url":"https://api.github.com/repos/tc39/test262/issues/477/comments","events_url":"https://api.github.com/repos/tc39/test262/issues/477/events","html_url":"https://github.com/tc39/test262/issues/477","id":128374778,"number":477,"title":"Definition for frontmatter id tags","user":{"login":"leobalter","id":301201,"avatar_url":"https://avatars.githubusercontent.com/u/301201?v=3","gravatar_id":"","url":"https://api.github.com/users/leobalter","html_url":"https://github.com/leobalter","followers_url":"https://api.github.com/users/leobalter/followers","following_url":"https://api.github.com/users/leobalter/following{/other_user}","gists_url":"https://api.github.com/users/leobalter/gists{/gist_id}","starred_url":"https://api.github.com/users/leobalter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/leobalter/subscriptions","organizations_url":"https://api.github.com/users/leobalter/orgs","repos_url":"https://api.github.com/users/leobalter/repos","events_url":"https://api.github.com/users/leobalter/events{/privacy}","received_events_url":"https://api.github.com/users/leobalter/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2016-01-24T05:36:49Z","updated_at":"2016-02-01T19:03:39Z","closed_at":"2016-01-29T17:32:09Z","body":"As mentioned at https://github.com/tc39/test262/issues/472#issuecomment-173006824:\r\n\r\n> @littledan: Rather than IDs which point to specific spec sections, I think it'd be much more useful to have ids that are the anchors within the document. These are much more likely to be consistent across releases. You could call these esids.\r\n\r\nBased on this, and as it's easy to locate the section ids on tc39/ecma262 on each of the `emu-clause` tags, which are expected to be unique, I believe we can use the respective hash id for the Frontmatter's `id` and further versions:\r\n\r\n```yaml\r\nid: sec-completion-record-specification-type\r\n```\r\n\r\nthis value can be converted to links that could be found anywhere:\r\n\r\n- https://tc39.github.io/ecma262/#sec-completion-record-specification-type\r\n- http://www.ecma-international.org/ecma-262/6.0/index.html#sec-constructor-properties-of-the-global-object\r\n- mylocalcopy#sec-constructor-properties-of-the-global-object\r\n\r\nThis reference works good and it's still compatible with the previous formats, as won't conflict with the recently adopted `es7id: pending` value, which can be easily replaced by `id: pending` and it's still useful for anything on Stage 3 and it's not on the draft yet.\r\n\r\n@goyakin, do you like this idea?"},"comment":{"url":"https://api.github.com/repos/tc39/test262/issues/comments/178131536","html_url":"https://github.com/tc39/test262/issues/477#issuecomment-178131536","issue_url":"https://api.github.com/repos/tc39/test262/issues/477","id":178131536,"user":{"login":"jugglinmike","id":677252,"avatar_url":"https://avatars.githubusercontent.com/u/677252?v=3","gravatar_id":"","url":"https://api.github.com/users/jugglinmike","html_url":"https://github.com/jugglinmike","followers_url":"https://api.github.com/users/jugglinmike/followers","following_url":"https://api.github.com/users/jugglinmike/following{/other_user}","gists_url":"https://api.github.com/users/jugglinmike/gists{/gist_id}","starred_url":"https://api.github.com/users/jugglinmike/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jugglinmike/subscriptions","organizations_url":"https://api.github.com/users/jugglinmike/orgs","repos_url":"https://api.github.com/users/jugglinmike/repos","events_url":"https://api.github.com/users/jugglinmike/events{/privacy}","received_events_url":"https://api.github.com/users/jugglinmike/received_events","type":"User","site_admin":false},"created_at":"2016-02-01T19:03:39Z","updated_at":"2016-02-01T19:03:39Z","body":"I'm a little late to the party, but I'd like to know more about the decision to use the name `id` instead of `esid` as suggested by @littledan. The latter is a few more characters, but I think it's preferable. Many tests will share the same value, and that contradicts commonly-held assumptions about \"IDs\". `esid` (or even `specid`) makes it clear that this value is reference to an identifier of some other document (and also gives a hint as to *which* document it refers).\r\n\r\nThere wasn't any discussion about why the change was made, so I thought I'd ask here."}}