Tuesday, September 28, 2010

Re: API design rant!

Not to mention none of those three things have to do with "API Design"...

On Tue, Sep 28, 2010 at 12:01 PM, Thomas Broyer <t.broyer@gmail.com> wrote:


On Sep 28, 4:29 pm, Greg Dougherty <dougherty.greg...@mayo.edu> wrote:
> 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.

Which doc are you talking about? the "CSS length units" part? (what
more should it say? if you don't know what a CSS length unit is, you'd
better stop doing web dev; or start learning CSS) the values and
valueOf part? (they're not in the code, they come with the "enum"
type, just like "extends java.lang.Enum<Style.Unit>")

> 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.

You mean these test cases?
http://code.google.com/p/google-web-toolkit/source/browse/trunk/user/test/com/google/gwt/

> Given that, why are there no *LayoutPanels in Showcase?

Fixed: http://code.google.com/p/google-web-toolkit/source/detail?r=8766

--
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.


--
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.

No comments:

Post a Comment