Andrew Kaspick wrote:
<snip>
The submission process for patches doesn't mention updating associated
documentation (as far as I can see). This should also be a
requirement along with test cases so that documentation stays up to
date. If we're planning on having good documention and we use the
fund money to improve what we already have then we should make sure we
try keep it that way.
I agree with this completely. The only way to guarantee an acceptable
level of in code documentation is to require that code updates are
accompanied by documentation updates, just as they are required to have
test updates. Indeed, requiring documentation should make for better
code as coders are forced to think more about their code from a user's
standpoint.
Tom
--
Tom Werner
Helmets to Hardhats
Software Developer
[EMAIL PROTECTED]
www.helmetstohardhats.org
_______________________________________________
Rails-core mailing list
Rails-core@lists.rubyonrails.org
http://lists.rubyonrails.org/mailman/listinfo/rails-core
