W3C home > Mailing lists > Public > www-tag@w3.org > January 2014

Re: Guidance on the usage of promises for API developers

From: Ashok Malhotra <ashok.malhotra@oracle.com>
Date: Tue, 14 Jan 2014 19:38:02 -0500
Message-ID: <52D5D86A.6060804@oracle.com>
To: www-tag@w3.org
Can you add an abstract on what promises are, how they help, their place in the spec world,
that sort of thing.
All the best, Ashok

On 1/13/2014 5:49 PM, Domenic Denicola wrote:
> In the past, the TAG has discussed producing a document on how to use promises in spec text. There's even a placeholder on GitHub [1].
>
> In the process of writing the ES6 promises spec, I ended up producing such a document myself [2]. It feels like an OK start to me, with some great feedback from Marcos incorporated a month ago.
>
> I'd be happy to push this document forward as a more official TAG work product. Presumably we'd move it to its own repository and all that. But first, I'd love to solicit feedback from spec authors and readers on what's currently there, and what you think should be there. Is it clear? Is it useful? For those writing specs using promises, have they found its guidance helpful, or have they found other tips that would be good to include? Several of the "guidance" points were drawn from finding mistakes in existing drafts that use promises; are there more drafts we should review?
>
> Feedback much appreciated, either here, or as an issue on the spec repository where the document currently lives [3]. (Note that I'm mostly concerned with content for now; we can worry about formatting later.)
>
>
> [1]: https://github.com/w3ctag/promises-spec-text
> [2]: https://github.com/domenic/promises-unwrapping/blob/master/docs/writing-specifications-with-promises.md
> [3]: https://github.com/domenic/promises-unwrapping/issues/new
Received on Wednesday, 15 January 2014 00:38:33 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:33:24 UTC