RE: Informative notes

2015-02-02 Thread Domenic Denicola
From: es-discuss [mailto:es-discuss-boun...@mozilla.org] On Behalf Of Benjamin (Inglor) Gruenbaum I think a centralised site similar to php's for holding all proposals currently discussed as well as a place for people to leave comments or directing them to this mailing list. Way ahead of

Re: Informative notes

2015-02-02 Thread Benjamin (Inglor) Gruenbaum
This looks sweet Domenic! Especially things like https://github.com/tc39/Array.prototype.includes/blob/master/README.md It would be great it if were standardised and made more readable (the sidebar for example) On Mon, Feb 2, 2015 at 11:43 PM, Domenic Denicola d...@domenic.me wrote: From:

Re: Informative notes

2015-02-02 Thread Brendan Eich
Benjamin (Inglor) Gruenbaum wrote: For example - I don't need to know or understand what `[[ReferenceGet]]` is to understand something written in this sort of style: https://wiki.php.net/rfc/combined-comparison-operator Not bad -- we are using gists and github markdown but could build that

RE: Informative notes

2015-02-02 Thread Domenic Denicola
From: es-discuss [mailto:es-discuss-boun...@mozilla.org] On Behalf Of Brendan Eich Not bad -- we are using gists and github markdown but could build that up to mimic the PHP structure and style a bit, if enough people find value in it. FYI the new hotness is Ecmarkup + Ecmarkdown as in e.g.

Re: Informative notes

2015-02-02 Thread Benjamin (Inglor) Gruenbaum
Not bad -- we are using gists and github markdown but could build that up to mimic the PHP structure and style a bit, if enough people find value in it. PHP's ircmaxell told me they're using WikiText - for example: https://wiki.php.net/rfc/combined-comparison-operator?do=editrev=0 It shouldn't

Re: Informative notes

2015-02-02 Thread Axel Rauschmayer
Regarding the general idea of motivation/introductory materials, I think the new process explicitly encourages this, and indeed most new proposals include that in their README or similar. Examples: - https://github.com/tc39/Array.prototype.includes/blob/master/README.md -

Informative notes

2015-02-02 Thread Axel Rauschmayer
On 22 Jan 2015, at 10:29 , Brendan Eich bren...@mozilla.org wrote: ECMA-357 (E4X) pioneered informative-first prose sections, not found in ECMA-262 Ed. 3, and as a direct consequence, had too many imprecise or even inaccurate informative notes, which (turns out) were misread as normative

Re: Informative notes

2015-02-02 Thread Benjamin (Inglor) Gruenbaum
Follow-up thought: people still link to the (completely outdated) proposals on the wiki, because they are often very readable. I think people mostly link to them because they are rank pretty well in search results and are confined to a single problem in a readable way. I think the way PHP

Re: Informative notes

2015-02-02 Thread Axel Rauschmayer
a...@rauschma.de wrote: On 22 Jan 2015, at 10:29 , Brendan Eich bren...@mozilla.org mailto:bren...@mozilla.org wrote: ECMA-357 (E4X) pioneered informative-first prose sections, not found in ECMA-262 Ed. 3, and as a direct consequence, had too many imprecise or even inaccurate informative notes