[EMAIL PROTECTED] wrote:
Hi,
If you are following the commit log, everybody is urging for getting more
and more code covered with Javadoc and internal code documentation.
Actually there was a couple of files and whole packages commited with *no*
javadoc at all or even without licenses headers.
We are far of discussing about @inerhitDoc tags or small details, so
modules take lot of effort to be understood and back-documented. I would
like thanks all the pals who are working to sort those issues backward.
We need to avoid going to review-then-commit mode, so please take a look
at other commit and yell hard when you see something without the minimum
of doc for making the code maintenable.
I think we don't need to have every commit with enormous javadoc with
inline examples, but at least a comment for each public method and for
each class header.
Julien
I totally +1 what Julien wrote !
Thanks !
--
--
cordialement, regards,
Emmanuel Lécharny
www.iktek.com
directory.apache.org
