Versions Compared

Old Version 25

changes.mady.by.user Jessica Crouch

Saved on

compared with

New Version 26

changes.mady.by.user Jessica Crouch

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

(If you want to make a feature request, follow the instructions in How to Request a New Feature)

The ArchivesSpace team encourages all users of the ArchivesSpace application to report any bugs encountered during use of the application. 

Note
iconfalse

Before reporting a bug

  • determine that the bug has not already been fixed by updating to the latest release and attempt to replicate the problem in it;
  • review the unresolved bugs logged in the ArchivesSpace development project to see if the bug has already been reported, in which case you can indicate in the existing report that you also encountered the bug instead of creating a new ticket; and, if desirable,
  • post a message to the ArchivesSpace Users Group list, asking for help in understanding and verifying the bug you encountered. To post to the list you will need to be staff of an ArchivesSpace member organization.

Once you have determined the bug has not been previously reported

...

  1. Log in to your Jira account (You will need to create a JIRA account to submit a ticket)
  2. Access JIRA  and select Create issue (Select ArchivesSpace New Workflow as the project)Indirectly via the “Send Feedback or Report a Problem” option appearing at the bottom of pages in the ArchivesSpace application in many installations. That link will bring you to the directions on this page. If that link is not there or not pointing to the current address, go directly to JIRA and select Create to create an issue, as in #1.

An actionable bug report requires the following:

...

  1. Issue Type identified as “Bug”

  2. Summary description of the problem encountered. It should be a short and specific title of the issue

    , for example:

...

  1. . (Example: Wrap and tag editor does not work

...

  1. )

  2. A detailed description of the issue.  This includes:

    1. Steps to reproduce: describe the steps leading up to the problem. Keep each step simple, specific and unambiguous. Include relevant URLs and prefer using a noun to a pronoun.  

      Info
      iconfalse
      Example:
      Edit a resource on Staff User Interface by browsing ''/staff/resources/<resource id>/edit"
      Mark an agent link as "primary" by clicking the respective "Make primary" button.
      Save the resource
      Click on Export → Download MARCXML


    2. Expected Results versus the Actual Results: explain what you expected to happen and what actually happened.

      Info
      iconfalse

      Example:
      Expected result: ”An 1xx field should appear in the MARCXML export of the resource”
      Actual result: "No 1xx field appears in the in MARCXML export of the resource"


    3. Visual proof, screenshots, screencasts or other documents

      Info
      iconfalse

      Note:
      It is helpful to take a screenshot or a screencast of the whole browser where the URL of the viewed page and all the relevant context is visible. Seeing just       a button that has a wrong label does not help as it does not show where in the UI the button appears and in what context.

      It is highly encouraged to include other relevant documents, such as an an excel file that causes an error while being imported.



  3. Assign a priority according to the severity of the issue.  The rankings range from the trivial (lowest) to blocker (most severe).

  4. Whenever possible, please assign relevant labels.  Example  Example: accessibility, digital_objects, agents, etc.

  5. Affects Version/s is the version of the ArchivesSpace application in which the problem was encountered

Note: The other data fields will be used internally by the ArchivesSpace program team and can be disregarded.

Upon submission of the ticket, the program team will contact the submitter and all other commenters directly via the ticket.  

...