W3C home > Mailing lists > Public > public-sysapps@w3.org > May 2013

Re: Showing APIs to the ECMAScript world

From: Marcos Caceres <w3c@marcosc.com>
Date: Thu, 9 May 2013 18:13:59 +0100
To: Micheil Smith <micheil@brandedcode.com>
Cc: "public-sysapps@w3.org" <public-sysapps@w3.org>
Message-ID: <2CFE0E91F1B640EDBA61B5A2E4D899DB@marcosc.com>



On Thursday, May 9, 2013 at 5:56 PM, Micheil Smith wrote:

> Hmm, that's an alright point, however, if developers are copying and pasting 
> code, then they probably aren't really understanding or caring about what it 
> does.
> 
> I think it'd make sense to use a sensible default, and then communicate that.
I tend to agree (I made exactly the same comment previously). I have a feeling this one is going to keep coming up.   
> If you mean something as a boolean, it probably makes more sense to be a 
> boolean, even if developers may occasionally copy and paste code from 
> some examples on the web.

>From a self documenting code POV, it would be nice to have it in the options dictionary: 

var options = {respectTimezones: true} 

And have it default to false (or the other way around depending on which one is going to be used the most). 
> Also, as a user of this API, do you really want to always be explicit in setting 
> whether you want to respect timezones or not? I have a small feeling that 
> developers would actually use the Data attribute more-so over change the 
> respecting of timezones.

FWIW, I also agree. 

-- 
Marcos Caceres
Received on Thursday, 9 May 2013 17:14:30 UTC

This archive was generated by hypermail 2.4.0 : Thursday, 1 July 2021 16:04:43 UTC