Difference between revisions of "Documentation/Nightly/Report a problem"

From Slicer Wiki
Jump to: navigation, search
Line 6: Line 6:
 
** Try your best to sort out the issue by reading documentation, mailing list archives, and checking error logs
 
** Try your best to sort out the issue by reading documentation, mailing list archives, and checking error logs
 
*** Look at our [[Documentation/UserTraining|portfolio of training materials]] and make a google search to see, if the question has been discussed in the mailinglists.
 
*** Look at our [[Documentation/UserTraining|portfolio of training materials]] and make a google search to see, if the question has been discussed in the mailinglists.
*** I am still unclear about what to do. In this case, sign up for the slicer user mailing list: [http://massmail.bwh.harvard.edu/mailman/listinfo/slicer-user Sign-up]
+
*** I am still unclear about what to do. In this case, [http://massmail.bwh.harvard.edu/mailman/listinfo/slicer-users sign up] for the slicer user mailing list and ask your question there
 
*** Check the [[Documentation/{{documentation/version}}/SlicerApplication/ErrorLog#To_capture_the_entire_error_log_for_a_report|Error Log]] to see if there's something misconfigured, such as a directory that is not readable or writable.
 
*** Check the [[Documentation/{{documentation/version}}/SlicerApplication/ErrorLog#To_capture_the_entire_error_log_for_a_report|Error Log]] to see if there's something misconfigured, such as a directory that is not readable or writable.
 
*Something is definitely not working as it should or I would like to request a feature.
 
*Something is definitely not working as it should or I would like to request a feature.

Revision as of 15:26, 11 June 2015

Home < Documentation < Nightly < Report a problem


For the latest Slicer documentation, visit the read-the-docs.


User Feedback

  • I have a question about how to use Slicer for a particular task or I'm not sure things are working right
    • Try your best to sort out the issue by reading documentation, mailing list archives, and checking error logs
      • Look at our portfolio of training materials and make a google search to see, if the question has been discussed in the mailinglists.
      • I am still unclear about what to do. In this case, sign up for the slicer user mailing list and ask your question there
      • Check the Error Log to see if there's something misconfigured, such as a directory that is not readable or writable.
  • Something is definitely not working as it should or I would like to request a feature.
    • File a bug report in the issues tracker (you need to register first). It is important to provide enough specific information so that a software developer can duplicate the problem. See below for more details.
    • Be sure to check the Error Log and include any related information in your report
    • Don't be anonymous: real people trying hard to solve real problems are more likely to get valuable help. A vague question from a random email is likely to be ignored..
  • I would like to let the Slicer community know, how Slicer helped me in my research.
    • Please send us the citation for your paper.
    • Background: funding for Slicer is provided through competitive mechanisms to a large extent by the US government and to a lesser extend through funding from other governments. The justification of for those resources is that Slicer enables scientific work. Knowing about scientific publications enabled by Slicer is a critical step in this process. Given the international nature of the Slicer community, the nationality of the scientists is not important. Every good paper counts.
  • I would like to give feedback on my experience with Slicer.
    • Share your story using the Feedback link accessible from the Slicer Welcome module

Workflow for Handling Bugs and Feature Requests in Slicer

The following instructions describes the recommended workflow to report a problem related to Slicer application.

  • 2. Sign-up on the developers mailing list
  • 3. Create an issue in the tracker. For example, see issue #1906
  • 5. Send an email on the slicer-developers list pointing to the reported bug. Title of the email should start with [BUG 1234] Title of the bug



The following diagram illustrates Slicer issue workflow:

Mantis-workflow.png

Source: Adapted from http://www.warelab.org/blog/?p=24