Skip to content

Allow a Release's associated Milestones to be edited through the "Edit Release" page

Problem to solve

Changing a Release's associated Milestones is only possible through the Releases API.

Proposal

User story

As a Release Manager, I want to associate milestones to my release item using the application's UI, so that I can manage the data related to the release progress.

🖼 SEE UX PROTOTYPES IN THE DESIGN TAB 🖼

Acceptance criteria

  • On the Release form, user sees a new form option for Milestones.
  • Any data available should be pre-populated on edit view.
  • A search component should be available.
  • User should be able to select 1 (one) or multiple milestones.
    • When selecting multiple milestones, the placeholder in the component will display the name of the first selected milestone plus +N more (+ 1 more, + 2 more...)
  • User should be able to add and remove items from their selection.
  • User should be able to set No milestone by selecting an option in the dropdown menu.
  • If no milestones exist in the project, user should be able to select the option create a new one from the Dropdown menu.
  • User should be able to have an option to manage milestones. Clicking Manage milestones will take users to the Milestones page https://gitlab.com/gitlab-org/gitlab/-/milestones
  • The field is not mandatory.
  • When saving the Release item and adding a new milestone, the data associated should reflect the release progress counter (issues), as well as be displayed in the Milestones page. Example:

Further details

Any data available should be pre-populated on edit view.

Releases can be associated with 0, 1, or multiple Milestones.

This feature should also be available when creating a new Release through the UI (not yet implemented - see #39464 (closed)).

This proposal will require an update to the milestones dropdown component to support multiple selection, and new actions, but only applicable to the Releases form.

Documentation

This page will likely need to be updated with new screenshots and instructions.

Edited by Rayana Verissimo