Hi, Andy and all.

On Sun, 18 Aug 2002 23:21:42 -0400
"Andrew C. Oliver" <[EMAIL PROTECTED]> wrote:

> To be honest Tetsuya, it makes me scared to use it.  Javadoc to me is so 
> basic and takes so little time, to actually argue against it...  To me 
> this is the same as an argument to write variables a1, a2, a3... Its 
> code quality.  This is an active argument for poor code quality and I 
> can't believe this is controversial!

I know your feelings, but it seems that it is the difference of 
"where and when to put our milestones" things.
For example, "our objectives at version 2.1 are not necessary 
complete javadocs, but at version 3.0, complete javadocs are
necessary" ... I think (for example) this is possible.

--

I agreed with Noel's opinion, "But javadocs for developers is not a 
reason to hold end users hostage", because this matter also applies
to the translation.
To catch up with frequently changed javadocs (to keep in sync) is
very difficult and almost impossible things.
The difference between this two Japanese Translation Groups(?)
http://www.terra-intl.com/jakarta/
http://www.ingrid.org/jajakarta/
is apparent. I (the former one) clearly declared " I will not
translate Javadocs because external documents are very important
for the PROMOTION of jakarta-projects but javadocs are different."
That's why I can speed it up to translate 9 jakarta-projects (including
JAMES) and the latter could not, it seems.

That's why I love the Noel's sentence.

Regards,

-- Tetsuya Kitahata <[EMAIL PROTECTED]>



--
To unsubscribe, e-mail:   <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>

Reply via email to