Skip to content

Create items

Usage: ddqa create [OPTIONS] PREVIOUS_REF CURRENT_REF

  Create QA items.

Options:
  -l, --label TEXT  Labels that will be attached to created issues  [required]

As an example, to create items for a hypothetical 7.44.0 release where the previous release was a patch, you might do:

ddqa create 7.43.1 7.44.0 -l 7.44.0-qa -l 7.44.0-rc.1

Creation screen full

Queue

This section tells you how many PRs or direct commits are queued up for assignment. This will also display the status of API retries due to rate limits.

Creation screen queue

Candidates

This section displays the list of candidates for assignment. Clicking will render data about the candidate in the right panel.

Creation screen candidates

Title

This section displays a short description about the candidate, using the title for PRs and Git metadata for direct commits.

You may Ctrl+Left Button the identifier on top to navigate to the candidate in your preferred web browser.

Creation screen candidate title

PR labels

If the candidate is a PR then its labels will render here.

Creation screen candidate PR labels

Description

This section displays detailed information about the candidate, using the PR body or Git metadata for direct commits.

Creation screen candidate description

Pending assignments

This section displays a toggle for each team determining whether they should be assigned to the candidate. The default state of each team's toggle will be enabled if any of the candidate's PR labels match the team's defined labels.

Creation screen candidate assignments

Creation

When you are satisfied with the pending candidate assignments, you may click the button to begin the process of Jira issue creation.

Creation screen transition

Tip

It is likely that your Jira profile is set up to automatically watch issues that you create, including those via the API. If you would like to disable this temporarily so you don't get notifications for everything, you may do the following:

  1. Go to your profile settings page on the Jira instance https://<ORG>.atlassian.net/secure/ViewPersonalSettings.jspa
  2. Change the Watch your issues option to Disabled

Progress

The queue section will transition to showing you the progress of QA item creation.

Creation screen progress

Items

The candidate listing will be reduced to just those that have been assigned. The number on the left refers to the number of teams that have had an issue created for that candidate.

Creation screen items

Results

The assignments section will now display the created issue for each team. You may Ctrl+Left Button the assigned team member or Jira issue to open in your preferred web browser.

Creation screen results

Note

When each candidate is assigned, the priority is based on whoever has been assigned the least amount of items, followed by whoever did not review the candidate (if it is a PR). Assuming that when an assignment is about to happen and everyone on the team has the same number of assigned items and everyone reviewed (or did not) the candidate, then the result is completely random.

You may exit by pressing Ctrl+C or the button.

Creation screen exit

Last update: June 2, 2023