[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [eclipse.org-architecture-council] API spec feedback


Wenfeng, I'll give a couple of brief comments. My questions/comments will seem rudementary since I know so little about using/extensing BIRT.
But, perhaps at that it'll demonstrate how you can better introduce new, naive users like me  :)

I do think its pretty good, along the right lines and format seemed easy to use, thought I'm not familar with it (Is it entirely on web? Or is there a version available from local system, once BIRT SDK installed?)
I didn't notice many examples, but did just skim it quickly.
Also, in many of the references, it did not seem to address error conditions (e.g. resource in use exceptions, disk full, not to mention just passing bad parameters, etc.).
Am I reading this right ... that this spec, and add-in-providers would have to work entirely in _javascript_? (well, with the little bit of XML that points to the _javascript_?).
I sort of missed the "traditional" ways that people extend Eclipse .. subclasses and extensions to extension points ... are there simply none? (If so, you might make that
more obvious to an Eclipse audience).

Well, I know its not much, but thought I'd start there, so you wouldn't think no one was reading it :)

David




"Wenfeng Li" <wli@xxxxxxxxxxx>
Sent by: eclipse.org-architecture-council-bounces@xxxxxxxxxxx

05/19/2005 10:58 PM

Please respond to
"eclipse.org-architecture-council"

To
"eclipse.org-architecture-council" <eclipse.org-architecture-council@xxxxxxxxxxx>
cc
Subject
[eclipse.org-architecture-council] API spec feedback






Fellow architecture council members

We had a great discussion on API specs. in our council meeting.  I would like to get your feedback on the way how BIRT are creating specs

Following are the links to BIRT's report object model "API" spec.

Documentation link...
http://www.eclipse.org/birt/ref/

Reference link..
http://www.eclipse.org/birt/ref/rom/index.html

Please send me your comments and places that we can improve.

Also pointers and links that exemplify good API spec are appreciated.

Thanks


Wenfeng Li
PMC Lead
Eclipse Business Intelligence & Reporting Tools Project
<http://www.eclipse.org/birt/>
Tel: 650-837-2222


_______________________________________________
eclipse.org-architecture-council mailing list
eclipse.org-architecture-council@xxxxxxxxxxx
https://dev.eclipse.org/mailman/listinfo/eclipse.org-architecture-council