Re: Comments on the API document (version of Monday

Hi Ivan,

> O.k. I think my main concern is really the way we present these things in the current document.
> We have to realize that we have different constituencies and they should be treated separately.

Yes, definitely. I think we're all on the same page here, and the plan
is that the document is going to gradually 'stretch' so that the first
part gets easier and easier, with all the detail save for the last
section (aimed at implementers).

I say 'first and last' rather than 'first and second', because there
may be an argument for having another section, aimed at the more
experienced JavaScript programmer. But that will hopefully be answered
naturally, as the document progresses, and we decide on an ongoing
basis whether something is too complex for a beginner.

Regards,

Mark

--
Mark Birbeck, webBackplane

mark.birbeck@webBackplane.com

http://webBackplane.com/mark-birbeck

webBackplane is a trading name of Backplane Ltd. (company number
05972288, registered office: 2nd Floor, 69/85 Tabernacle Street,
London, EC2A 4RR)

Received on Thursday, 20 May 2010 13:23:16 UTC