Uploaded image for project: 'Request For Comments'
  1. Request For Comments
  2. RFC-147

Best practices to report an issue with DM system

    Details

    • Type: RFC
    • Status: Adopted
    • Resolution: Done
    • Component/s: DM
    • Labels:
      None

      Description

      Recent discussions in hip chat and in JIRA exposed it'd be good to have a well defined policy describing best practices related to reporting issues by users. Below I typed proposed narrative, comments / improvements are welcome.

      This RFC should be implemented by incorporating this text into one or both of pipelines.lsst.io and developer.lsst.io.

      Recommendations for filing a new issue:

      • Project: DM
      • Issue Type: use the "bug" or "improvement" issue type. The former should be used to report flaws / failures, the latter should be used to request an improvement or a new feature
      • Summary: short description of the issue
      • Priority: make a guess, or leave default. Use blocker or critical for truly blocking issues.
      • Component: set it if it is obvious. Do not create new components (request needed components from a JIRA admin)
      • Fix Versions: leave empty
      • Assignee: set to "Unassigned"
      • Watchers: leave empty, or add developers that you'd like to be alerted about your issue
      • Description: type the description, paste relevant error messages, snippets from log files and anything else that you think may help us understand the issue. This might include things like operating system (and browser, if web-based); eups setups (eups list -s); input data; the command that's producing the issue; the actual output from that command; the expected output from the command etc.
      • Story Points: do not set it, leave it for the domain expert to make the assessment
      • Linked Issues / Issue: leave blank
      • Epic Link: leave blank
      • Sprint: leave blank
      • Team: feel free to set it if you know which team it falls into

        Attachments

          Container Issues

            Issue Links

              Activity

                People

                • Assignee:
                  jbecla Jacek Becla
                  Reporter:
                  jbecla Jacek Becla
                  Watchers:
                  Frossie Economou, Gregory Dubois-Felsmann, Jacek Becla, John Parejko, John Swinbank, Jonathan Sick, Kian-Tat Lim, Paul Price, Robert Lupton, Russell Owen, Tim Jenness, Xiuqin Wu
                • Votes:
                  1 Vote for this issue
                  Watchers:
                  12 Start watching this issue

                  Dates

                  • Created:
                    Updated:
                    Resolved:
                    Planned End:

                    Summary Panel