+1
My suggestion would be to retain technically complete but minimalistic
Javadocs, and link from the Javadoc to the wikidoc (and also link from
the wikidoc to the Javadoc).
The underlying goal is to single-source the documentation, and avoid
cutting-and-pasting between assets. One way to single-
Hi all,
I agree the snippet macro is quite useful to keep for example
attributes for tags in sync with the documentation in the wiki.
However, using that same technique to include a summary and/or
examples seems to be less fitting. It's often hard to write good and
well formatted samples in the j