# JIRA Agile Usage¶

Refer to DMTN-020 for detailed information on the JIRA-based planning process used by DM.

## Key Concepts¶

• Cycles (aka Releases) occur every 6 months.
• Epics are higher-level features or capabilities that are to be delivered in a cycle. Epic names should be short and descriptive.
• Stories describe concrete, demonstrable features to be delivered in a single sprint.
• Story points are to be assigned at 2 story points per full-time uninterrupted day of an appropriate developer.

## Teams¶

The JIRA “team” field is used to define financial and managerial responsibility for getting the work done. We recognize the following teams:

Team Name Responsible Manager
System Management Wil O’Mullane
DM Science Leanne Guy
Architecture K-T Lim
Science User Interface Xiuqin Wu
Data Access and Database Fritz Mueller
Data Facility Michelle Butler
International Comms and Base Site Jeff Kantor
SQuaRE Frossie Economou
Telescope and Site Andy Clements
External None (see below)

The “External” team is used to label work done by individuals who are not funded by LSST.

In general, every ticket should be assigned to a particular team — otherwise, nobody is responsible for ensuring it gets done. If you aren’t sure which team to assign a ticket to, just leave the field blank, and one of the T/CAMs will pick it up. In the exceptional case that the ticket describes work which could be done by either of the Science Pipelines teams (Alert Production and Data Release Production), but it’s not clear which, it can be marked with the label SciencePipelines instead of setting the team.

## Labels¶

We support and encourage the use of labels to group related tickets. Their use is not formally restricted or regulated. However, there are a few labels which are of general interest:

Label Meaning
dm-sst This work is of interest to the DM System Science Team.
dm-set This work is of interest to the DM Systems Engineering Team.
DMLT This work is of interest to the DM Leadership Team.
gen3-middleware Work on the “generation 3” Butler and associated middleware (e.g. SuperTask).
SciencePipelines Work which should be performed by either AP (02C.03) or DRP (02C.04), but it’s not (yet) clear which so we can’t easily set the “team” field

In addition, please label any tickets describing work performed on documents with an assigned document handle with that handle (DMTN-123, LDM-456, LSE-789, etc).

## Components¶

You can assign one or more components to tickets to describe which part or parts of the system they affect. Components are selected from a pre-defined list; only JIRA administrators have the ability to add new components. The following guidelines may be helpful when choosing components:

• If the ticket involves working in one or more software repositories, add the corresponding components (for example, afw, daf_butler, ap_association). If no component exists for the repository you are working in, ask your T/CAM for help.
• If the ticket involves work on a document, choose a component that best describes the type of the document you are working on (for example, Design Documents, Review Documents, Requirements Documents). Even if the document is hosted in a Git repository, don’t add that repository as a component; use a label label instead.