- From: Scott Rowe <scottrowe@google.com>
- Date: Tue, 6 Nov 2012 18:15:21 -0800
- To: Nebojša Ćirić <cira@google.com>
- Cc: Eliot Graff <Eliot.Graff@microsoft.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
- Message-ID: <CAHZLcPp=hwiJdBK5xwGT5SheXyCyzSinu3cTugjFsNOgrg5U6Q@mail.gmail.com>
Hi all, I'm actually in the middle of developing a proposal for the apis documentation using WebRTC as the poster child. I've uncovered many problems, and I will propose solutions in the write-up. I hope to have it complete by the end of the week. +Scott On Tue, Nov 6, 2012 at 10:08 AM, Nebojša Ćirić <cira@google.com> wrote: > This is a wonderful opportunity for us to be crisp and clear about how we > document emergent standards-based APIs that have yet to be implemented. > > The API is stable it's just not available in all browsers yet (Firefox is > probably next to have support after Chrome, then IE). > > Off the top of my head, I am not sure we have this part of the process > documented anywhere, but if not, we should. And this API could be the > poster child for the correct documentation process. > > How should we go about that? Should I just post the docs under > JavaScript/Internationalization for now, then move them if new process > emerges? > > ** ** >> >> *From:* Nebojša Ćirić [mailto:cira@google.com] >> *Sent:* Monday, November 5, 2012 10:02 AM >> *To:* public-webplatform@w3.org >> *Subject:* Adding EcmaScript Internationalization API to webplatform.org* >> *** >> >> ** ** >> >> The v1.0 draft<http://wiki.ecmascript.org/doku.php?id=globalization:specification_drafts>was approved at the TC39 meeting in September, and browser vendors are >> working on implementations (Chrome v24 will provide full support, Chrome >> v22 has it but prefixed). Take a look at >> http://code.google.com/p/v8-i18n/w/list for a quick overview.**** >> >> ** ** >> >> I would like to add documentation about the API and use cases to the >> webplatform.org. Where would be a good place to put it? Quick browse of >> the repository hints at:**** >> >> 1. http://docs.webplatform.org/wiki/javascript, new subtopic >> Internationalization**** >> >> 2. http://docs.webplatform.org/wiki/javascript, under subtopic of "Other >> concepts"**** >> >> ** ** >> >> I prefer option 1, because it makes it look less optional for a developer. >> **** >> >> ** ** >> >> Regards, >> Nebojša Ćirić**** >> > > > > -- > Nebojša Ćirić >
Received on Wednesday, 7 November 2012 02:15:50 UTC