GitLab for Jira app: Add instructions/guidance step to self-managed setup flow

Description

During the installation flow for the GitLab for Jira app, there are many manual steps required by users that may be challenging. Until we are able to automate and improve the UX for this flow (in a future follow-up), we want to supply additional context to users going through this process.

At minimum, this should include a link to our docs with some explanation or high level steps.

https://docs.gitlab.com/ee/integration/jira/connect-app.html#connect-the-gitlabcom-for-jira-cloud-app-for-self-managed-instances

Ideally, we could embed a video walkthrough showing users how to complete the setup.

Design

See wireframes in Figma.

added to epic &5650 (closed)

changed title from Add instructions/guidance step to self-managed setup flow to Add instructions/guidance step to self-managed setup flow for GitLab for Jira app

changed the description

added devopsmanage frontend groupintegrations [DEPRECATED] sectiondev typefeature labels

changed milestone to %15.7

mentioned in epic &5650 (closed)

@justin_ho Can you estimate this issue?

@dmishunov Not sure, but you may be able to help while @justin_ho is

Setting this to frontend-weight3 to account for working with GitPod and allow a bit more time for polish in all the steps of the setup.

@justin_ho This should be your first priority when you are back because this is a blocker for the release post: gitlab-com/www-gitlab-com!110680 (comment 1188987205).

changed title from Add instructions/guidance step to self-managed setup flow for GitLab for Jira app to GitLab for Jira app: Add instructions/guidance step to self-managed setup flow

marked this issue as related to #370324 (closed)

Setting label(s) Category:Integrations based on ~"group::integrations".

added Category:Integrations label

added Deliverable label

mentioned in issue #370324 (closed)

mentioned in epic &9307 (closed)

assigned to @justin_ho

added IntegrationJira JiraGitLab for Jira Cloud app labels

set weight to 3

added workflowready for development label

mentioned in merge request gitlab-com/www-gitlab-com!110680 (merged)

mentioned in issue gitlab-org/quality/triage-reports#10249 (closed)

@g.hickman I don't have access to the Figma wireframe from the link in the description. Is the link correct?

@Andysoiron Is the new documentation the link that we have to add here?

I'm trying to clarify all the requirements here.

@arturoherrero yes, this is the right link

@arturoherrero Hmm, do you have Figma access?

You should be able to view. I tried to see if I could add you specifically and your name didn't appear. Let me know if I can help somehow!

That was my mistake. I can see the file after logging in with the Figma credentials from 1Password.

changed the description

added quad-planningcomplete-no-action label

mentioned in merge request !106263 (merged)

added workflowin review label and removed workflowready for development label

mentioned in issue #372967 (closed)

added workflowproduction label and removed workflowin review label

mentioned in issue #385514

Just a note that I haven't included the Tutorial video part as it was noted as good-to-have and we haven't recorded that yet. I'll create a follow-up to add it as polish in a separate issue (and split out weight 1 there).

Closing this as done for now.

Thanks @justin_ho!

closed

set weight to 2

added groupimport and integrate label and removed groupintegrations [DEPRECATED] label