On Tuesday 19 November 2002 18:12, Andy Lewis wrote: >. . . > I agree that DEVELOPER documentation should be in the source files. But not > user documentation....
same here. The killer argument is that you don't want non-programmers to make changes to java source files because they're changing the *user documentation* of the component. Also, a component might (often should ;-) be written in multiple java source files, in which case having a separate XML doc file for the component as a whole makes it clear where the documentation is. -Bertrand
