Move merge request navigation tabs below title and consolidate description and widget in Overview tab
Problem to solve
The diff, commit list, and pipelines tab usability is decreased by having a long description and merge widget above them all the time because means the top of the page doesn't actually show what I am trying to look at.
Intended users
Further details
The currently location of merge request navigation tabs has surfaced as sub-optimal in interviews with multiple customers, and in investigating #27600 (closed), #31300 (closed), and https://gitlab.com/gitlab-org/gitlab-ce/issues/62536.
Recent user testing of file-by-file diff navigation ux-research#341 (closed) included this change, and was positively received. Although questions about the file-by-file navigation remain, adjusting the navigation tabs was well received.
Proposal
To provide more predictable and easy to find navigation within a merge request, and to provide greater focus in each area of the merge request:
- move the merge request navigation tabs above the description
- only show the description and merge widget on the Overview tab (replacing the discussions tab)
Since early research was very positive, we are confident that this deserves maximum exposure:
- Add a feature flag, off by default, without a need for the user preference. We can then progressively enable the feature on GitLab.com.
- Add an explanatory popover (see image below) with a button to dismiss (saved as a cookie?) and a link to an feedback issue.
- To collect feedback, we can publish a blog post that links to the feedback issue and share it internally and on social media.
Permissions and Security
None. This change is cosmetic only, rearranging information that is already visible.
Documentation
The hero screenshot on https://docs.gitlab.com/ee/user/project/merge_requests/ will need to be updated.
Testing
What does success look like, and how can we measure that?
Qualitative feedback from customers will validate if usability has improved.
In combination with the real performance gains of &1816, we would like the reduced visual weight to further incease perceived performance.