Marc Portier <mpo <at> outerthought.org> writes: > > Some of my TOC additions embedded, feel free to comment... > > (incorporated the suggestions from issue 21 and those made in this > thread already) > > I also added a big section on doing reslet based development as I think > there is a big difference in listing 'what it is and does' versus 'how > one should combine things to solve typical problems' > > other suggestions? > > regards, > -marc=
[...deleted...] I was just about to follow up on the original TOC saying that it looked too much like a reference manual. I think you are right on, Marc, in suggesting to include a beefy amount of 'how to'. My personal preference for Java projects is to only focus on how to and let the JavaDoc worry about "what it is." but maybe that's too extreme. I'm thinking about the DRY principle here.
