W3C home > Mailing lists > Public > public-device-apis@w3.org > January 2010

Re: ISSUE-67: Naming of "device"

From: Brian LeRoux <brian@westcoastlogic.com>
Date: Thu, 14 Jan 2010 14:49:16 -0800
Message-ID: <a4bcf6321001141449j2a3fd398od25192a4accfe8ac@mail.gmail.com>
To: Marcin Hanclik <Marcin.Hanclik@access-company.com>
Cc: Doug Turner <w3c@dougt.org>, "richard.tibbett@orange-ftgroup.com" <richard.tibbett@orange-ftgroup.com>, "public-device-apis@w3.org" <public-device-apis@w3.org>
Correct you are! The order of love:

tequilla
api
device
ext
service

The order of hate:

service
ext
device
api

Its somewhat funny how we've gotten used to 'device' so there was some
surprise and resistance to change at first.




Brian LeRoux, Nitobi Software
---
Office: +1 (604) 685-9287
Toll-Free (North America Only): 1-866-632-2777
Cell: +1 (604) 868-1978
http://blogs.nitobi.com/brian
http://www.nitobi.com
http://twitter.com/brianleroux



On Thu, Jan 14, 2010 at 2:18 PM, Marcin Hanclik
<Marcin.Hanclik@access-company.com> wrote:
> Hi Brian,
>
> Just for the sake of clarity:
> I think the order of your preferences is reversed as compared to the others, but the argumentation is clear.
>
>>>ordered from the one you *hate
>>> most* (and therefore want to see voted off the island) to
>>> the one you
>>> hate least.
> I.e. the list is to be driven by hate and not love ;)
>
> Cheers,
> Marcin
> ________________________________________
> From: brian.leroux@gmail.com [brian.leroux@gmail.com] On Behalf Of Brian LeRoux [brian@westcoastlogic.com]
> Sent: Thursday, January 14, 2010 11:15 PM
> To: Marcin Hanclik
> Cc: Doug Turner; richard.tibbett@orange-ftgroup.com; public-device-apis@w3.org
> Subject: Re: ISSUE-67: Naming of "device"
>
> Did a quick informal poll of the phonegap implementors and there is
> some agreement on the deprecation of device in favor of api as it is
> less characters and we are not always dealing with devices (car
> dashboards or perhaps the beer fridge come to mind). We are not in
> favor of turning the device into a server and mocking xhr's for
> everything: this technique would be slow, insecure, confusing and
> wrapped into a local interface anyhow.
>
> In summary:
>
> api
> device
> ext
> service
>
> Thanks!
>
>
> On Thu, Jan 14, 2010 at 2:10 PM, Marcin Hanclik
> <Marcin.Hanclik@access-company.com> wrote:
>> Hi Doug,
>>
>> I think it is about grouping.
>> navigator.device.(module|interface).method was intended for device APIs, so "device" made sense.
>> There is semantics behind that.
>>
>> However, the discussions about allowing the APIs to be realized based on a webservice (locally within the device, smart card over http: or remotely), i.e. potentially decoupling them from the actual device, remove the association between the actual device and "navigator.device", IMHO.
>> Therefore I now assume that another name could be selected :(.
>>
>> Taking into account Robin's RSI arguments, I think that api, ext would work (Tim Berners-Lee already apologized for slashes [1] :) ) .
>> service is very general and fits semantically, but it is simply longer.
>>
>> The need to have something between navigator and (module|interface in WebIDL sense) seems to have resulted from having undocumented (in W3C sense) properties on navigator. The "grouping" principle solved this issue by adding just one new property (green, anti-pollution argument).
>>
>> Another idea could be to have "dap", i.e.
>> navigator.dap.(module|interface).method
>> simply in honor of the DAP WG :)
>> If there will be next WGs (in W3C or somewhere else), they could e.g. group their APIs under their group's name.
>>
>> Thanks,
>> Marcin
>>
>> [1] http://news.bbc.co.uk/2/hi/8306631.stm
>> ________________________________________
>> From: public-device-apis-request@w3.org [public-device-apis-request@w3.org] On Behalf Of Doug Turner [w3c@dougt.org]
>> Sent: Thursday, January 14, 2010 9:00 PM
>> To: richard.tibbett@orange-ftgroup.com
>> Cc: public-device-apis@w3.org
>> Subject: Re: ISSUE-67: Naming of "device"
>>
>> ... people found it clearer, more extensible, less conflict with other
>> existing properties of navigator
>>
>>
>> Anyone care to elaborate? what conflicts are there today?  how is adding another object under navigator more extensible?
>>
>> Thanks!
>> Doug
>>
>>
>>
>> On Jan 14, 2010, at 9:54 AM, <richard.tibbett@orange-ftgroup.com> wrote:
>>
>>> Ah, referenced the wrong minutes:
>>>
>>> [2]
>>> http://lists.w3.org/Archives/Public/public-device-apis/2010Jan/0105.html
>>> (13th Jan 2010)
>>>
>>>> -----Original Message-----
>>>> From: TIBBETT Richard RD-ILAB-LON
>>>> Sent: 14 January 2010 17:53
>>>> To: 'Doug Turner'
>>>> Cc: public-device-apis@w3.org WG
>>>> Subject: RE: ISSUE-67: Naming of "device"
>>>>
>>>> Hi Doug,
>>>>
>>>> On the conf. call we resolved to go with 'Option 1:
>>>> navigator.device.dahut.graze()' [1].
>>>>
>>>> Meeting minutes are available here [2].
>>>>
>>>> Best Regards,
>>>>
>>>> Richard
>>>>
>>>> [1] 'Resolution #90' in http://www.w3.org/2009/dap/track/resolutions
>>>>
>>>> [2]
>>>> http://lists.w3.org/Archives/Public/public-device-apis/2010Jan
>>>> /0036.html
>>>>
>>>>> -----Original Message-----
>>>>> From: public-device-apis-request@w3.org
>>>>> [mailto:public-device-apis-request@w3.org] On Behalf Of Doug Turner
>>>>> Sent: 14 January 2010 16:49
>>>>> To: Anssi Kostiainen
>>>>> Cc: Robin Berjon; public-device-apis@w3.org WG
>>>>> Subject: Re: ISSUE-67: Naming of "device"
>>>>>
>>>>> My option isn't in the list, so I will state it plainly.
>>>> My position
>>>>> is that we use:
>>>>>
>>>>> navigator.<module>.<method>
>>>>>
>>>>> as
>>>>>
>>>>> 1) .device. offers no real namespace and it is extra characters to
>>>>> type
>>>>> 2) it fit in navigator.geolocation.*
>>>>>
>>>>>
>>>>> Widgets or other things that do not have a navigator object
>>>> can root
>>>>> these APIs under a different object (e.g.
>>>>> widget.<module>.method, or even <module>.method)
>>>>>
>>>>> By the way, the bike shed must be red.
>>>>>
>>>>> Doug Turner
>>>>>
>>>>>
>>>>> On Jan 14, 2010, at 6:13 AM, Anssi Kostiainen wrote:
>>>>>
>>>>>> api, ext, device, service
>>>>>>
>>>>>> With tequila? Yes sir!
>>>>>>
>>>>>> -Anssi
>>>>>>
>>>>>> On 14.1.2010, at 16.02, ext John Kemp wrote:
>>>>>>
>>>>>>> api, ext, device, service
>>>>>>>
>>>>>>> Are you inviting us for tequila too (in which case, I
>>>>> accept) Robin?
>>>>>>> ;)
>>>>>>>
>>>>>>> - johnk
>>>>>>>
>>>>>>> On Jan 14, 2010, at 8:41 AM, Robin Berjon wrote:
>>>>>>>
>>>>>>>> Hi all,
>>>>>>>>
>>>>>>>> I am loth to open a naming debate, so as agreed on the
>>>>> call yesterday let's make it swift. I initially planned on
>>>> doing this
>>>>> on a Friday, but I won't be around tomorrow so today's the
>>>> new Friday.
>>>>>>>>
>>>>>>>> We've resolved to use the
>>>>> navigator.device.<module>.<method> form yesterday (for APIs
>>>> where it
>>>>> makes sense, naturally). It's been suggested that "device"
>>>> isn't such
>>>>> a great name, and alternatives have been proposed.
>>>>>>>>
>>>>>>>> The following alternative (including keeping things as
>>>>> they are) have been proposed:
>>>>>>>>
>>>>>>>> device
>>>>>>>> service
>>>>>>>> api
>>>>>>>> ext
>>>>>>>>
>>>>>>>> Since this is essentially a bike-shed decision, I've
>>>>> decided to use a variant of the Survivor decision process.
>>>>> The normal Survivor process is synchronous and therefore won't work
>>>>> well here. The variant is this: please vote with the list
>>>> of options
>>>>> above ordered from the one you *hate
>>>>> most* (and therefore want to see voted off the island) to
>>>> the one you
>>>>> hate least. The winner will be selected using a commonsensical
>>>>> ordering and tequila. Voting closes when I get to work
>>>> Monday morning;
>>>>> since this is a vote (albeit
>>>>> informal) we don't need to know what the reasoning behind your
>>>>> preference is (though you may include it, if it's entertaining
>>>>> enough).
>>>>>>>>
>>>>>>>> My vote: api, ext, device, service.
>>>>>>>>
>>>>>>>> --
>>>>>>>> Robin Berjon
>>>>>>>> robineko - hired gun, higher standards http://robineko.com/
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>>
>>>>>>>
>>>>>>>
>>>>>>
>>>>>>
>>>>>
>>>>>
>>>>>
>>>
>>> *********************************
>>> This message and any attachments (the "message") are confidential and intended solely for the addressees.
>>> Any unauthorised use or dissemination is prohibited.
>>> Messages are susceptible to alteration.
>>> France Telecom Group shall not be liable for the message if altered, changed or falsified.
>>> If you are not the intended addressee of this message, please cancel it immediately and inform the sender.
>>> ********************************
>>>
>>
>>
>>
>> ________________________________________
>>
>> Access Systems Germany GmbH
>> Essener Strasse 5  |  D-46047 Oberhausen
>> HRB 13548 Amtsgericht Duisburg
>> Geschaeftsfuehrer: Michel Piquemal, Tomonori Watanabe, Yusuke Kanda
>>
>> www.access-company.com
>>
>> CONFIDENTIALITY NOTICE
>> This e-mail and any attachments hereto may contain information that is privileged or confidential, and is intended for use only by the
>> individual or entity to which it is addressed. Any disclosure, copying or distribution of the information by anyone else is strictly prohibited.
>> If you have received this document in error, please notify us promptly by responding to this e-mail. Thank you.
>>
>>
>
> ________________________________________
>
> Access Systems Germany GmbH
> Essener Strasse 5  |  D-46047 Oberhausen
> HRB 13548 Amtsgericht Duisburg
> Geschaeftsfuehrer: Michel Piquemal, Tomonori Watanabe, Yusuke Kanda
>
> www.access-company.com
>
> CONFIDENTIALITY NOTICE
> This e-mail and any attachments hereto may contain information that is privileged or confidential, and is intended for use only by the
> individual or entity to which it is addressed. Any disclosure, copying or distribution of the information by anyone else is strictly prohibited.
> If you have received this document in error, please notify us promptly by responding to this e-mail. Thank you.
>
>
Received on Thursday, 14 January 2010 22:49:49 UTC

This archive was generated by hypermail 2.3.1 : Monday, 23 October 2017 14:53:41 UTC