Uploaded image for project: 'Data Management'
  1. Data Management
  2. DM-9966

Recommend that TODO comments link to Jira

    XMLWordPrintable

    Details

      Description

      Following discussion on RFC-307, this ticket adds the following rule to the Python style guide:

      To-do comments SHOULD include a Jira issue key

      If the commented code is a workaround for a known issue, this rule makes it easier to find and remove the workaround once the issue has been resolved. If the commented code itself is the problem, this rule ensures the issue will be reported on Jira, making it more likely to be fixed in a timely manner.

      # TODO: DM-12345 is triggered by this line
      

      # TODO: workaround for DM-6789
      


      and the following rule to the C++ style guide:

      6-26. To-do comments SHOULD include a Jira issue key

      If the commented code is a workaround for a known issue, this rule makes it easier to find and remove the workaround once the issue has been resolved. If the commented code itself is the problem, this rule ensures the issue will be reported on Jira, making it more likely to be fixed in a timely manner.

      // TODO: DM-12345 is triggered by this line
      

      // TODO: workaround for DM-6789
      

        Attachments

          Issue Links

            Activity

            No work has yet been logged on this issue.

              People

              Assignee:
              krzys Krzysztof Findeisen
              Reporter:
              krzys Krzysztof Findeisen
              Reviewers:
              Kian-Tat Lim
              Watchers:
              Jim Bosch, Jonathan Sick, Kian-Tat Lim, Krzysztof Findeisen
              Votes:
              0 Vote for this issue
              Watchers:
              4 Start watching this issue

                Dates

                Created:
                Updated:
                Resolved:

                  Jenkins

                  No builds found.