> > How about changing: > > > > [snip] > > The Release Notes document the new features and bug fixes that have been > > included in this release. > > > > The JavaDoc API documents are available online. In particular, you should > > read the package description for the org.apache.commons.digester package > > for detailed information on using the package. > > [snap] > > > > to: > > > > The Release Notes document the new features and bug fixes that have been > > included in this release. > > > > The Documentation is part of the JavaDoc API documentation. In particular, > > you should read the package description for the org.apache.commons.digester > > package for detailed information on using the package. > > > > The JavaDoc API documents are also available online. > > I think this is a good suggestion, so I have made some minor changes to > the "index.xml" xdoc file. I don't have Maven installed, so rather than > commit the change without having tested it, here is a patch that I hope > some maven user can test & apply.
> > > > I would suggest the following to prevent another one falling some traps > > I went through and wasted 4 hours of my life. Well not wasted entirely > > but it wasn't that productive also. > > > > a) refactor the The JavaDoc API documentation is available... and > > split it up and mention the documentation being part of the api in > > first place. > Sorry, I don't understand this. Refactor what and how? Split what up? Well refactoring means taking the old changing its structure without changing its content. Thats why I applied it here. It does simply mean what you 've done when creating the index.xml :) > > > > > b) alter the package documentation to reflect whats happening when > > it comes to self containment. (tag contains itself as child, the information > > was lagging). > > Can you provide a patch to the existing package.html file which includes > the information you want? I will proof-read it for you. Well ok. Simply I would like to add a part about self-containment of tags. (The question I had and the solution to it). Thanks, Martin (Kersten) --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
