26 Jul
2013
26 Jul
'13
8:47 p.m.
Hi, To promote contribution and encourage code brevity, I would like to remove the rule that we fail the build over a missing javadoc on a non-public field. It's important to understand, this is *not* about encouraging developers to skimp on documentation! There are obvious cases such as 'logger' where the role of the field is blatantly clear and forced documentation is at best useless and at worst counterproductive because it creates an information overload for the code reader and hides the comments which the author really wanted to be seen. +1 for dropping this rule Thanks, Caleb