Introduction to Jira and the disease surveillance dashboard

Dear Case Based Surveillance Community

The DHIS 2 core team have for the last year started using Jira
<https://jira.dhis2.org> for bug and issue tracking for all DHIS 2
software. This means any bugs encountered, features requested or
improvements wanted should be posted on Jira. However, with so many users
contributing, feature and improvement request, we are quickly reaching a
vast amount of issues reported. To simplify users interaction with Jira, we
have already created different dashboards to summarise the current state of
development for certain aspects of DHIS 2, including Disease Surveillance,
Analytics and Tracker.

In this email, we want to show you how to make these dashboards readily
available to you and explain the disease surveillance dashboard in
particular. This email assumes you already have an account on Jira, or are
able to go to Jira and register a new account
<https://jira.dhis2.org/secure/Signup!default.jspa&gt;\.

To access Jira, you can use the following url: https://jira.dhis2.org

Finding and and setting a dashboard as favourite

Step 1: Log in to Jira <https://jira.dhis2.org>
Step 2: Go to "Dashboard > Manage Dashboards" in the top menu

image

Step 3: Go to "Popular Dashboards" to find the "Disease Surveillance
Dashboard" and click the star to the left to select as favourite.

image

Step 4: You can now access the Disease Surveillance Dashboard by clicking
"Dashboards -> Disease Surveillance Dashboard". If this is your only
dashboard, you will go to this dashboard each time you log in.

Disease Surveillance Dashboard explained

image

*"Issue Statistics: IDSR - Issues for current release (Resolution)"*
This widget gives a quick overview of the issues finished (resolved) and
issues still to do or in progress (unresolved). This statistic represents
the issues targeted for the next unreleased version.

*"Filter Results: IDSR - Epic"*
Disease Surveillance has an epic, which is a super-issue issues can be
assigned to. To make it easier to access, we created a link to this issue
right in the dashboard. If you want more information about the epic or the
disease surveillance discussions you can click here.

*"Pie Chart: IDSR - Issues for current release"*
Issues can have multiple statuses, and this piechart will give an overview
of the current status for all the issues in the next unreleased version.

A quick introduction to the statuses:

Open - This issue have not been processed yet or might need more
information.
Todo - When an issue has been planned for implementation, it will progress
from Open to Todo.
In Progress - Work has begun on the issue
In Review - Implementation is complete, and code either awaits peer-review
or feedback from feature owners
Testing - Issue is being tested for bugs
Documentation - Feature or improvement is being documented
Done - Issue is considered resolved and will not receive any more work

*"Filter Results: IDSR - Issues for current release"*
This is a list of all issues that have been targeted for the current
release (Next unreleased version). Here you can easily access issues and
comment, vote or watch issues that you are interested in.

*"Filter Results: IDSR - Unresolved bugs"*
This widget lists all bugs that are directly related to the disease
surveillance work. Since bugs work slightly different than other issues,
this list might not always reflect all bugs that are affecting the disease
surveillance features. This list requires manual input to add a bug to the
list, so we will try to keep this is up-to-date as possible.

*"Filter Results - IDSR - Future Issues"*
These issues are connected to the disease surveillance epic and is either
not targeted to a specific release, or a future version. This list includes
all the different unresolved statuses, including open issues.

--
Stian Sandvold
Software developer, DHIS2
University of Oslo