Hacker0x01 · stacyspiva · May 7, 2019 · May 7, 2019
diff --git a/docs/programs/images/jira-cloud-works-1.png b/docs/programs/images/jira-cloud-works-1.png
diff --git a/docs/programs/images/jira-cloud-works-2.png b/docs/programs/images/jira-cloud-works-2.png
diff --git a/docs/programs/images/jira-cloud-works-3.png b/docs/programs/images/jira-cloud-works-3.png
diff --git a/docs/programs/images/jira-cloud-works-4.png b/docs/programs/images/jira-cloud-works-4.png
diff --git a/docs/programs/images/jira-cloud-works-5.png b/docs/programs/images/jira-cloud-works-5.png
diff --git a/docs/programs/jira-cloud-integration.md b/docs/programs/jira-cloud-integration.md
@@ -10,22 +10,46 @@ To integrate with Jira Cloud:
 1. Go to **Settings > Program > Integrations**.
 2. Click the **Connect with JIRA** link.
    ![jira-server-1](./images/jira-server-1.png)
+
 3. Choose **JIRA Cloud**, and you'll be redirected to Atlassian Marketplace where you can download the HackerOne for JIRA application.
+
    ![jira-server-3](./images/jira-server-3.png)
+
 4. Click the **Get it now** button in Atlassian Marketplace to install the HackerOne for Jira application. The page will redirect you to your Jira instance and the integration will be downloaded and installed.
+
    ![jira-cloud-1](./images/jira-cloud-1.png)
+
 5. Click the **Get started** button on the installation confirmation pop-up.
+
    ![jira-cloud-2](./images/jira-cloud-2.png)
+
 6. The installation process will continue on the HackerOne website and will ask you to select the program you want to link to. Select the program you want to link to your Jira instance.
+
    ![jira-cloud-3](./images/jira-cloud-3.png)
+
 7. The set up will take you to the Jira settings page where you can select which events you want to sync between HackerOne and Jira.
 
 With Jira integration, you can create Jira issues right from your HackerOne report.
 
-### Create Jira Issues from your HackerOne Report
+### How it works
 To create Jira issues from your HackerOne report:
-1. In the comments section of your report, change **Add comment** to **Change state > Triaged**.
-2. Click the **Create JIRA issue** button to create the issue in Jira.
+1. Go to the report you want to create a Jira issue for.
+2. Click **Edit** in the References field.
+
+  ![jira-cloud-works-1](./images/jira-cloud-works-1.png)
+
+3. Click **Create JIRA Issue**. A Jira ID will automatically generate.
+
+  ![jira-cloud-works-2](./images/jira-cloud-works-2.png)
+
+4. Click on the Jira ID to access the report in Jira.
+
+  ![jira-cloud-works-3](./images/jira-cloud-works-3.png)
+
+5. Add comments or change the state of the report in Jira.
+
+  ![jira-cloud-works-4](./images/jira-cloud-works-4.png)
+
+When you perform an action on the Jira report such as adding a comment or changing the status of the report, Hackbot will generate an internal comment on the HackerOne report to reflect the changes.
 
-Every time an action occurs on the Jira issue, Hackbot will automatically create an internal comment on the HackerOne report.
-![jira-cloud-4](./images/jira-cloud-4.png)
+  ![jira-cloud-works-5](./images/jira-cloud-works-5.png)
diff --git a/docs/programs/jira-server-integration.md b/docs/programs/jira-server-integration.md
@@ -17,15 +17,23 @@ To integrate with Jira Server:
    ![jira-server-2](./images/jira-server-2.png)
 
 4. Navigate to the Application Links console of JIRA by going to **JIRA Administration > Applications > Application Links**.
+
+> **Note:** You must be a Jira administrator in order to set up and access the Jira integration settings. After you set up your integration, you can go back to regular access on Jira.
+
    ![jira-server-7](./images/jira-server-7.png)
+
 5. Enter `https://hackerone.com` and click **Create new link**.
    ![jira-server-8](./images/jira-server-8.png)
+
 6. Enter `https://hackerone.com` in the New URL field in the Configure Application URL window.
    ![jira-server-9](./images/jira-server-9.png)
+
 7. Enter `HackerOne` for the Application Name and select `Generic Application` in the Link applications window and click **Continue**.
    ![jira-server-10](./images/jira-server-10.png)
+
 8.  Select the pencil icon for HackerOne on the Configure Application Links page.
    ![jira-server-11](./images/jira-server-11.png)
+
 9. Enter the following information on the Application Details section of the Configure HackerOne window:
 
 Field | Details
@@ -75,7 +83,7 @@ State Changes | When someone changes the state of a report, post an update on th
 Rewards | When someone awards or suggests a bounty and/or bonus, post an update on the associated Jira issue.
 Assignee Changes | When someone assigns a user/group to a report, post an update on the associated Jira issue.
 Disclosure | When disclosure is requested or a report becomes public, post an update on the associated Jira issue.
-Synchronize attachments | *(Currently in beta)* Synchronize attachments linked with reports and comments to the associated Jira issue. 
+Synchronize attachments | *(Currently in beta)* Synchronize attachments linked with reports and comments to the associated Jira issue.
 
    ![jira-server-6a](./images/jira-server-6a.png)