On Fri, Nov 11, 2011 at 4:28 AM, Greg Brown <[email protected]> wrote:
> I don't see any reason why something like this couldn't be included in the
> documentation. Where do you think it should go?
I was thinking ideally in two places. At a minimum, it ought to be in
the javadoc for the various renderer interfaces. That's several
places (the current javadoc shows 6 subinterfaces of Renderer), but it
might be good enough to put it in Renderer and link the subinterfaces
to it, e.g., for ListView you could have "A {@link Renderer} to
control the display of items in a ListView", and programmers could
easily follow the link to the larger description. If you like, I
could draft something and submit a ticket.
The other place that would be nice would be a "Renderers" page in the
tutorial, somewhere down in the more advanced topics, like Data
Binding. It could talk about the idea of renderers in general, and
have a sample implementation of one. I'm not good at coming up with
compelling but simple examples, but maybe do one for a ListView where
the ListData is a list of Color objects make a renderer that displays
a color swatch and an rgb value.
