On Tue, Jun 23, 2009 at 08:40, Kalle Sommer Nielsen<[email protected]> wrote: > Hi > > 2009/6/23 Karoly Negyesi <[email protected]>: >> Hi, >> >> So I would like to add this but as this is a bit bigger and a bit >> different than the usual examples, I thought I will ask first. > > All in all the examples look good, but I don't think the example > para's should have been written like: > > "Instead of the following:" > <some long code> > > "You can use the much shorter:" > <some short code> > > I think they should be more descriptive, explaining what this does and > then the source code comments can indicate, you might want to do this > or that instead.
Making it a classreference example and changing the descriptions to "the following two are examples are equal, one using Iterator and the other IteratorAggregate" (or something along those lines) would maybe be better? I think its valuable to show that you can reduce a lot of code using that interface.. -Hannes
