Re: API design rant!

Well, look at the JavaDoc for extended by
com.google.gwt.dom.client.Style.Unit (AKA Style.Unit). I don't think
it's possible to write worse "Documentation" than that, other than
perhaps writing something that is actively and consistently wrong.

My general experience with reading the GWT JavaDoc is to ask "why did
this person even bother?" Presumable, anyone working on an Open
Source project is doing it because they want to create code that will
be USED. Which leaves me scratching my head wondering why they then
produce such crappy "examples" that you have to come to the discussion
group in order to figure out how to actually use the code.

I assume people actually test code before it gets added to the
project. I assume those text cases are a pretty through workout of
all the code's claimed features. It's an Open Source project, so I
assume there's no commercial reason to keep those test cases hidden.

Given that, why are there no *LayoutPanels in Showcase? Why does not
the GWT code tree have complete test implementations of every single
panel, testing out all their features (and, incidentally, letting the
rest of us see the programmer's idea of the best way to use those
features)?

Greg

On Sep 27, 9:38 am, Jaroslav Záruba <jaroslav.zar...@gmail.com> wrote:
> do you have some interesting showcase? :)
>
> On Mon, Sep 27, 2010 at 4:33 PM, dmen <dmenou...@gmail.com> wrote:
> > Have been working with datepicker.. This must be the nth time I think
> > gosh your component model and API are poorly designed! The compiler is
> > great sure, but *please* take a look at projects like Ext GWT of how
> > things should be done the-right-way before you introduce APIs the-
> > clumsy-way that will be around forever.
>
> > --
> > You received this message because you are subscribed to the Google Groups
> > "Google Web Toolkit" group.
> > To post to this group, send email to google-web-toolkit@googlegroups.com.
> > To unsubscribe from this group, send email to
> > google-web-toolkit+unsubscribe@googlegroups.com<google-web-toolkit%2Bunsubscribe@googlegroups.com>
> > .
> > For more options, visit this group at
> >http://groups.google.com/group/google-web-toolkit?hl=en.

--
You received this message because you are subscribed to the Google Groups "Google Web Toolkit" group.
To post to this group, send email to google-web-toolkit@googlegroups.com.
To unsubscribe from this group, send email to google-web-toolkit+unsubscribe@googlegroups.com.
For more options, visit this group at http://groups.google.com/group/google-web-toolkit?hl=en.