Hello Everyone, I am in the process of adding/modifying the javadocs for several of classes, interfaces and enums in the source code.
There are some identifiers that could benefit from the addition or updates of the javadocs at the class, method and paramater levels. This could improve the API Documentation especially for new comers looking through the code to figure out what is going on. I would like to know what is the better approach towards creating JIRA issues for these javadoc changes. (1) Create one JIRA issue for each .java file (class, interface or enum). (2) Create one JIRA issue for a group of classes, interfaces or enums within the same package. (3) Create one JIRA issue for a group of packages within the same module (flume-ng-core, flume-ng-sources, flume-ng-channels etc) (4) Create one JIRA and use it for all javadoc patches I am leaning towards (1) but I would like to know what others think?
