new ES6 draft, rev 18
The new revision is up in HTML format here: people.mozilla.com/~jorendorff/es6-draft.html
Source: jorendorff/es-spec-html
Note: With this revision, old links that pointed to specific sections using an anchor, like #sec-9.1.8, will mostly be broken with the new document. There is currently no way to make a permalink to a section of the document that's durable against future section renumberings. This is issue #41 and you can comment here: jorendorff/es-spec-html#41
As always your bug reports, patches, and suggestions are welcome. Send me e-mail, or file a issue on github, whatever's easier.
On Sep 5, 2013, at 14:12 , Allen Wirfs-Brock <allen at wirfs-brock.com> wrote:
Sections 17-26 define the ECMAScript standard library. It includes the definitions of all of the standard objects that are available for use by ECMAScript programs as the execute. In previous editions this was section 15. In the new organization all the property definitions for each object are now defined in alphabetical order. The built-ins are now groups into logical buckets rather than one giant chapter. The naming of sections 17-26 isn't necessarily final nor is the specific groupings. Feed back on this will be appreciated.
Very nice! I simply would have given each class its own chapter, but your grouping actually makes a lot of sense. And it's good to see that now each chapter is under 50 pages - although two of them are still longer than the entire Internationalization API spec...
Yes, +1 and more -- thanks, Allen!
I dunno if this'd be useful to anyone else or not (mentioning here to see whether anyone else sees value in this). But would it be possible for drafts to include the draft date in page headers, or overall PDF title, or somewhere easily-viewable without scrolling too far from any position in the spec?
I can't be the only one who usually has an out-of-date draft because I can't religiously follow es-discuss. It'd be nice to be able to guesstimate out-of-dateness quickly (>1-1.5mo === fair odds for out-of-date), without having to lose my current position by going to the start page.
At harmony:specification_drafts#september_5_2013_draft
This draft has essentially no new technical content relative to rev 17. However, the document has been completely restructured and the rev17 content has redistributed roughly like this:
Sections 6-9 define the execution environment within which ECMAScript programs operate. In previous editions, this was sections 8, 9,most of 10
Sections 10-16 define the actual ECMAScript programming language includings its syntactic encoding and the execution semantics of all language features. In previous editions this was sections 6,7,11-14,16, and parts of 10.
Sections 17-26 define the ECMAScript standard library. It includes the definitions of all of the standard objects that are available for use by ECMAScript programs as the execute. In previous editions this was section 15. In the new organization all the property definitions for each object are now defined in alphabetical order. The built-ins are now groups into logical buckets rather than one giant chapter. The naming of sections 17-26 isn't necessarily final nor is the specific groupings. Feed back on this will be appreciated.
This is the reorganization that was originally discussed in: esdiscuss.org/topic/thoughts-the-re-organization-of-the-specification