--- Chase <[EMAIL PROTECTED]> wrote: > I wasn't trying to say that Javadoc creates a user manual. > I was saying that it already documents the implementation > of the source so we don't need to do that again.
And we don't. One of the main issues is that too many examples are tied up in Javadocs rather than as live code. I don't know if Confluence's snippet impl will reach into arbitrary file types; if it does, that would certainly solve that problem. > I think the stated policy of try to make everything a snippet just > goes too far. The snippet macro does have some use but shouldn't be > the preferred way to create documentation content. It should if it's code or a code artifact, otherwise it's duplicated effort. Again, many of the issues are version- or markup-related: more a snippets impl issue than snippets proper. Dave --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]