Define guidelines for displaying third-party services in sidebar
With the work being done to extend our integrations with Atlassian (e.g. Jira, Confluence, OpsGenie) and other third-parties like Rally, VersionOne, etc., we need a consistent way of displaying these third-party services in the left menu bar.
Today most of our third-party services link off to their own sites:
| Jira | Custom Issue Tracker |
|---|---|
 |
 |
Proposal
Final decision, see #625 (comment 620008967)
-
Option A should be used (Round 1 options in archive) when third-party integrations are preferred over native functionality. Supporting comment: #625 (comment 370122794)
-
If, for example both GitLab and Jira issues are both enabled (not recommended), then we should nest the third-party integration under the corresponding native functionality. In this case, Jira issues would be nested under Issues. See #625 (comment 379188751)
For more specific examples and work being done in this area, see epic: gitlab-org&5831
| Example of Jira issue list enabled |
|---|
 |
| Example of Jira issue list enabled + GitLab issues (not recommended but possible) |
|---|
 |
Resources:
Proposal archive
Round 2 options
Based on the latest feedback and following comment #625 (comment 374447145)
Option B is the best candidate for the time being.
| Rest | Hover | Active | Active (hover) |
|---|---|---|---|
 |
 |
 |
 |
Round 1 options
Jira example:
| Option A | Option B | Option C | Option D |
|---|---|---|---|
 |
 |
 |
 |
Option A
We re-use the GitLab's corresponding icon
Option B
We use the third-party's icon/branding as they use it in their Favicon
Option C
We use the third-party's icon/branding but keep it contained within an avatar like square
Option D
We use the third-party's icon/branding but we limit the logos to 1-color, as mentioned here: #625 (comment 369121778)
Option E
We use don't use any third-party logos/branding and create a new "Integrations" menu item where all integration menu would exist.
| Option E |
|---|
 |