Show issue/epic navigation consistently in groups and projects
Proposal
In order to support group-level issues, and project-level epics (design issue, feature epic), we need to make navigation elements accessible that are currently in only a group or project so that users can find and manage those items. Specifically this proposes:
-
Global "Create new" menu:
- show "New issue" in groups with group-issues enabled (currently only in projects)
- show "New epic" in projects with epics enabled (currently only in groups)
-
Plan section:
- Show "Epics" and "Epic boards" in projects where Epics are enabled, pointing to new project-level epics pages
- We are still considering the possibility of consolidating issues/epic views, but any changes there would be separate from this effort and follow later.
- Show "Epics" and "Epic boards" in projects where Epics are enabled, pointing to new project-level epics pages
In all cases these navigation elements already exist — no totally new elements are proposed, or any changes to naming, only the logic of when they're shown.
Other locations that were considered
Given the established patterns, and a desire to ensure parity and consistency across groups/projects, no other locations were identified that could meet those goals.
We have explored more comprehensive reorganizations of how issues/epics are managed, which have different approaches to navigation, but that is beyond the scope of group/project parity for issues/epics.
Checklist
-
Review the handbook page for navigation changes -
Add relevant information to the issue description detailing your proposal, including usage and business drivers. -
List at least two other places you considered to introduce your feature -
Add relevant designs to the Design Management area of the issue -
Ensure your UI suggestion align with the Documentation Style Guide -
Engage Technical Writing. They can help craft a term that best describes the feature(s) you’re proposing. -
Follow the product development workflow validation process to ensure you are solving a well understood problem and that the proposed change is understandable and non-disruptive to users. Navigation-specific research is mandatory for additions or when restructuring. -
Engage the Foundations Product Manager for approval. The Foundations DRI ( @cdybenko) will work with UX partners in product design, research, and technical writing, as applicable. -
Consider whether you need to communicate the change somehow, or if you will have an interim period in the UI where your item will live in more than one place. -
Ensure engineers are familiar with the implementation steps for navigation.