How to work with Jira at SKAO

Step-by-step instructions for common Jira tasks.

Create a ticket

1. Click Create in the top navigation

2. Select the Project (your team’s project)

3. Choose the Issue Type (Story, Task, Bug, etc.)

4. Complete the required fields: - Summary — Brief description - Description — Detailed information - Assignee — Who will work on it

5. Click Create

Link a ticket to GitLab

Reference the Jira ticket ID in your GitLab work to create automatic links.

In branch names:

ska-123-add-feature-description

In commit messages:

git commit -m "SKA-123: Add feature description"

To mark a merge request as closing a ticket:

git commit -m "SKA-123: Add feature, closes SKA-123"

This links and marks the merge request as closing the ticket. It does not reliably change the ticket’s status at SKAO, so move the ticket to the next status manually (see Transition a ticket).

Transition a ticket

Move a ticket to a new status:

Option 1: From the board

• Drag the ticket to a new column

Option 2: From the ticket

1. Open the ticket

2. Click the Status dropdown

3. Select the new status

Add a comment

1. Open the ticket

2. Scroll to the Comments section

3. Type your comment

4. Click Save

Use @mentions to notify team members.

Filter tickets

Quick filters on boards:

Use the filter buttons above your board to show specific tickets.

JQL search:

Click Issues → Search for issues and use Jira Query Language:

project = <YOUR_PROJECT_KEY> AND assignee = currentUser() AND status = "In Progress"

Watch a ticket

Receive notifications about a ticket:

1. Open the ticket

2. Click Watch (eye icon)

Jira notifies you of status changes and comments.

See also

• Tutorial: Get started with Jira

• Jira reference

• Understanding Jira at SKAO