## Summary This subepic has been created to reflect all work needed to make the **epic** and **issue** listing pages ready for the transition to work items. Noting that post migration of epics and issues to work items, we will utilize the exisiting separate epic and issue listing page views until we create a [single agile planning listing page](https://gitlab.com/groups/gitlab-org/-/epics/5516#feature-iterations). ## Stages > [!important] GA for every stage is a requirement > > Every stage below is expected to be delivered fully to all customers: gitlab.com, self-managed, dedicated. Feature flags can be used during development and rollout, but should be completely removed. <table> <tr> <th>Delivery milestone</th> <th>Scope</th> <th>Parity with</th> <th>Paths</th> <th>WI Types</th> <th>Differences from previous steps</th> </tr> <tr> <td> 1. WI Group Epics List </td> <td>Group</td> <td>Legacy Epics List</td> <td> `/groups/gitlab-org/-/epics` </td> <td>epics</td> <td> On epics page: * New vue app on frontend * Using work items APIs </td> </tr> <tr> <td> 2. WI Project Issues List </td> <td>Project</td> <td>Legacy Project Issues List</td> <td> `/gitlab-org/gitlab/-/issues` </td> <td>issues, incidents, tasks, objectives, key results, test cases</td> <td> On project issues page: * New vue app * Using work items APIs </td> </tr> <tr> <td> 3. WI Group Issues List </td> <td>Group</td> <td>Legacy Group Issues List</td> <td> `/groups/gitlab-org/-/issues` </td> <td>issues, incidents, tasks, objectives, key results, test cases</td> <td> On group issues page: * New vue app * Using work items APIs </td> </tr> <tr> <td> 4. WI Consolidated List </td> <td>Group AND Project</td> <td> * WI Group Issues List * WI Group Epics List * WI Project Issues List </td> <td> * `/groups/gitlab-org/-/work-items` * `/gitlab-org/gitlab/-/work-items` </td> <td> * from groups: epics * from projects: issues, incidents, tasks, objectives, key results, test cases </td> <td> * redirecting `/issues` and `/epics` to `/work-tiems` for groups and projects * showing both project level and group level work items on the same page for groups </td> </tr> <tr> <td> * Project level Epics + Group level issues _(not part of this epic)_ </td> <td>Group AND Project</td> <td>TBD</td> <td> * `/groups/gitlab-org/-/work-items` * `/gitlab-org/gitlab/-/work-items` </td> <td>epics, issues, incidents, tasks, objectives, key results, test cases</td> <td> * Adding epics to projects * Adding issues to groups * ? Adding other work items (OKRs, tasks)... </td> </tr> <tr> <td> 5. Clean up </td> <td>Group AND Project</td> <td>NA</td> <td> * `/groups/gitlab-org/-/work-items` * `/gitlab-org/gitlab/-/work-items` </td> <td>epics, issues, incidents, tasks, objectives, key results, test cases</td> <td> * Removal of old pages and associated code </td> </tr> <tr> <td> 6. WI Group Consolidated List - Project parity _(not currently planned)_ </td> <td>Group</td> <td> * WI Project Issues List * WI Group Consolidated List </td> <td> `/groups/gitlab-org/-/work-items` </td> <td></td> <td>TBD</td> </tr> </table> ## Work to be done - [x] [Expose work items count by state on GraphQL (1)](https://gitlab.com/gitlab-org/gitlab/-/issues/390865) - [ ] Tokens on epic and issue lists must be supported - BE and FE (verification only) - [ ] [Bulk editing for work items - epic parity](https://gitlab.com/groups/gitlab-org/-/epics/11900) - BE and FE heavy, `labels` are the only requirement for epic migration - [ ] Import/Export - already supported on work items for limited data on both group and project level - work needed for parity ## Parity with legacy lists These are the issues that need to be completed to get to parity with their legacy versions. ### Epics list - https://gitlab.com/gitlab-org/gitlab/-/issues/480358+ - https://gitlab.com/gitlab-org/gitlab/-/issues/520026+ - https://gitlab.com/gitlab-org/gitlab/-/issues/463145+ - https://gitlab.com/gitlab-org/gitlab/-/issues/478633+ ### Issues list - https://gitlab.com/gitlab-org/gitlab/-/issues/510277+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510276+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510275+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510274+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510273+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510272+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510271+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510270+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510269+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510268+ - https://gitlab.com/gitlab-org/gitlab/-/issues/510267+