Re: [xwiki-devs] [VOTE] Relax checkstyle rule about javadoc on non-public class members.

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 _______________________________________________ devs mailing list devs(a)xwiki.org http://lists.xwiki.org/mailman/listinfo/devs