[jboss-jira] [JBoss JIRA] (DROOLS-1052) Remove @author tags from sources

Michael Biarnes Kiefer (JIRA) issues at jboss.org
Fri Dec 23 09:47:00 EST 2016


    [ https://issues.jboss.org/browse/DROOLS-1052?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13341794#comment-13341794 ] 

Michael Biarnes Kiefer commented on DROOLS-1052:
------------------------------------------------

Should I only look in the java files or in the drl files too?

What should I do in this case:
/**
 * Finds currently available server ports.
 *
 * @author <a href="mailto:dev at directory.apache.org">Apache Directory Project</a>
 * @see <a href="http://www.iana.org/assignments/port-numbers">IANA.org</a>
 */

There are a bunch of @authors in test java files, like i.e.
public class StandaloneDocBuilder {

    public static void main(String[] args) throws FileNotFoundException,
                                          ParseException {

        String drl = "";
        drl += "# important information\n";
        drl += "# about this package\n";
        drl += "# it contains some rules\n";
        drl += "package org.kie.test\n";
        drl += "global java.util.List list\n";
        drl += "# Really important information about this rule \n";
        drl += "# Another line because one was not enough \n";
        drl += "#  \n";
        drl += "# @author: trikkola \n";

Should this be removed too?

> Remove @author tags from sources
> --------------------------------
>
>                 Key: DROOLS-1052
>                 URL: https://issues.jboss.org/browse/DROOLS-1052
>             Project: Drools
>          Issue Type: Task
>            Reporter: Petr Široký
>            Assignee: Michael Biarnes Kiefer
>
> Some of our sources contain author Javadoc tags. As per our README ( https://github.com/droolsjbpm/droolsjbpm-build-bootstrap/blob/master/README.md#faq) we should not using those as they promote code ownership and discourage team work.
> We need to scan through the sources and remove those tags.
> See https://github.com/droolsjbpm/jbpm/commit/ff5fd1ea464fe791933b9ea436cd2c4cffd41b15 for example of removing the tags from one of the jBPM modules.



--
This message was sent by Atlassian JIRA
(v7.2.3#72005)



More information about the jboss-jira mailing list