Comment 2 for bug 1232054

Am updating platform-api so existing code just works.

Agreed on all those extra requirements, could you write those up somewhere so we can have a concrete list to consider in future?
Thanks
-G