Re: [eclipse.org-architecture-council] API spec feedback

[David M Williams <david_williams@xxxxxxxxxx>]

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