Reporting bugs: Difference between revisions

From EchinoWiki
Jump to navigation Jump to search
imported>Echinobase
imported>Echinobase
Line 3: Line 3:
However, it is very important that we can find your bug so that we can fix it.  
However, it is very important that we can find your bug so that we can fix it.  


'''To help us find your bug, please fill out form below, and [mailto:echinobase@ucalgary.ca e-mail it to us]!'''
'''To help us find your bug, please fill out form below, and [mailto:echinobase@ucalgary.ca e-mail it to us at echinobase@ucalgary.ca].'''
<div class="toccolours mw-collapsible mw-collapsed">
<div class="toccolours mw-collapsible mw-collapsed">
Echinobase Bug Report
Echinobase Bug Report

Revision as of 17:44, 15 April 2020

Reporting a bug in Echinobase

If you find a bug in Echinobase, we would really like to know! However, it is very important that we can find your bug so that we can fix it.

To help us find your bug, please fill out form below, and e-mail it to us at echinobase@ucalgary.ca.

Echinobase Bug Report

Date of bug- MM/DD/YYYY

approximate time at which the bug occurred: HH:MM:SS

Reporter:[your name] URL at which the bug occurred:[Give the urls from the pages where you first felt that something was wrong]

1. What is the problem? [A brief, one sentence explanation of the bug]

2. What were you trying to do? [A brief explanation of what you were trying to do when the bug occurred]

3. Please give a step-by-step summary of the actions you took from the time you decided to perform the action in question 2 to the time you experienced the bug in question 1. If you were searching for something or changing the properties of something (i.e. changing a user's address), please include the exact text you entered (as far as you can remember).

4. On a scale of 1 to 6, how will this bug impact your ability to use the website? [Put your answer HERE] [1= not at all] [4= Working around this bug requires significant changes in how I use Xenbase]

[6= While this bug exists, I cannot use Xenbase to do what I need to do]

You can find a sample form that has already been filled out here.

An explanation of how to fill out each of the fields and why they are helpful, is below.

Date and Time

These fields are necessary when someone reports a bug that we cannot find the cause of. We can check Echinobase's error logs at that date and time to see if any errors occurred which might tell us more about the bug.

The seconds of the time field need only be approximations.

1. What is the Problem?

Please provide a very short (1-2 sentence) summary of the problem.

2. What were you trying to do?

This field gives us some context as to what you were attempting to do. It helps us determine which page you were on and pages you were likely to have been on before that.

3. Step-by-step Summary

Write out, as well as you can remember, each and every step you took from the moment you decided to do the action in number 2 to the moment the bug from number 1 occurred.

Why is this summary important?

Some bugs may be crucial to Echinobase running correctly, but may only occur after a user has performed a very specific sequence of steps. The more specific you are about the steps you took (exactly which search box you used, where you reached an image edit page from, etc.)the easier it will be for us to isolate your bug.

An extreme example (unrelated to Echinobase) of how specific a bug report may need to be in order to isolate a bug can be found here. Each and every step from that bug report would need to be performed correctly in order to generate that bug.

That being said, we understand your time is valuable and very few bugs actually require a report in the above level of detail. Just tell us which buttons you pushed and which pages you navigated to and if we need more information, we will e-mail you. :-)

4. The Scale From 1 to 6

Unfortunately we cannot get to every bug as soon as it is submitted. Some bugs need to wait in our bug queue before we can fix them. To help us prioritize the ordering of these bugs in the queue, we would like to know how inconvenient these bugs are for you. The scale is summarized in the bug report above; however, a more detailed scale summary can be found below.

  1. = The problem does not affect my ability to use the website.
  2. = I can easily work around the problem.
  3. = I can work around the problem.
  4. = I can work around the problem with some difficulty.
  5. = It is very difficult to work around the problem.
  6. = I cannot work around the problem.