### Problem to solve Changing a Release's associated Milestones is only possible through the [Releases API](https://docs.gitlab.com/ee/api/releases/#update-a-release). ### 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. [:frame_photo: SEE UX PROTOTYPES IN THE DESIGN TAB :frame_photo:](https://gitlab.com/gitlab-org/gitlab/issues/39467/designs/releases__milestone.png) #### Acceptance criteria * On the Release form, user sees a new form option for Milestones. * The component behave similarly to the `Milestones` component on the `New issue` form. See https://gitlab.com/gitlab-org/gitlab/issues/new * 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. * Clicking the `Create new` option will take the user to the New milestone page https://gitlab.com/gitlab-org/gitlab/-/milestones/new * 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: * https://gitlab.com/gitlab-org/gitlab/-/milestones/30 * https://gitlab.com/gitlab-org/gitlab/-/milestones?sort=due_date_desc&state=all ### 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 https://gitlab.com/gitlab-org/gitlab/issues/39464). 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](https://docs.gitlab.com/ee/user/project/releases/#editing-a-release) will likely need to be updated with new screenshots and instructions.