Child pages
  • JIRA Authoring 101

Versions Compared

Key

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

...

  1. Now that you know where it happens, search for the issue in Sakai JIRAs!

  2. Some ways to search (with examples):

    1. With a filter someone has provided - access the link!

    2. Search by tool (or something like Accessibility or Internationalization): Component = [tool name]

    3. Search in the text: text ~ "multiple choice"

    4. Find jiras by status: status = Open

    5. Find jiras assigned to you: assignee = currentUser()

    6. Mix it up, e.g., component = accessibility Accessibility AND component = "Tests & Quizzes (Samigo)" AND text ~ "multiple choice" AND status = Open

Part 2: Support or Report

...

  1. Make sure it has complete information for it to be addressed.  If not, add information in the Description and/or Testing Steps.

  2. Start watching it.

  3. Add a Comment to let others know you’ve experienced it too (you can also provide information in comments if it does not belong in the Description or Testing Steps).

  4. Link to related issues by selecting the More menu, then Link.  Search for and select or enter the JIRA numbers (e.g. SAK-#####) to add related jiras.  Links are extremely helpful to ensure that people can find the information they need in JIRA and most importantly, when fixes for several issues need to be applied together, they are all included!

  5. Select Vote for this issue to vote for it.

If it does not exist, create a jira:

Watch a video for how to create a jira.

General Tab

  1. Issue type: Bug if it is not behaving correctly, Feature Request if it is behaving as expected, but needs improvement.

  2. Summary: The title (brief description of issue)

  3. Priority: Defaults to Major; if not sure, leave it.  Blocker is for something that totally destroys functionality and will prevent release of the affected Sakai version.

  4. Components: Affected tools or features (e.g. Accessibility, Internationalization)

  5. Affects versions: Include ALL the most recent Sakai versions it affects.

  6. Assignee: Leave default (Automatic)

  7. Environment includes:

    1. URLs of server(s) where you tested it,

    2. Computer operating system,

    3. Internet browser and version,

    4. If you are using additional technology (such as a screen reader), the software and version.

  8. Description: Try to explain it as clearly as possible.  If you have screen shots, you can attach these and embed them in the description (see below, the Tips under the description of the Testing Tab, for steps to embed).

  9. Attachment: Screen shots or , a text file with a copy of a bug report (if one appears while reproducing the issue) or other files (e.g., an exported quiz for someone to reproduce the issue) - you can embed or link these attachments right in the jira text too!

  10. Security Level: Usually leave default (None) - security jiras are sensitive issues like holes for hackers to exploit.

  11. Labels: Optional - these can help you search for the issue, some examples: TL if you want Teaching & Learning call to look at it, Accessibility or a11y, Internationalization or i18n.

  12. Fix Version/s: Leave default (empty) - these get added after the issue is fixed.

...

  1. Pretend you are explaining to someone who is coming to Sakai (or your tool) for the first time.  Be as thorough as possible!

  2. Use a numbered list for the steps.  If authoring in Text, enter # with a space after it on each line to make a numbered list item.

  3. If it isn’t obvious, indicate the desired behavior also for bugs (what should happen when fixed?)

  4. If you added attachments, insert them where appropriate (it really helps to have a screen shot inline with the text!)  If authoring in Text, place the attachment name in between two exclamation marks, e.g. !screenshot.png!  For large screen shots, you can embed a thumbnail image, e.g.: !screenshot.png|thumbnail!

After Creation

After creating the jira, Link to related issues by selecting the More menu, then Link.  Search for and select or enter the JIRA numbers (e.g. SAK-#####) to add related jiras.  Links are extremely helpful to ensure that people can find the information they need in JIRA and most importantly, when fixes for several issues need to be applied together, they are all included!