Update Jira and Linear integration documentation

Author: karan925

docs/integrations/Jira/link.md

@@ -1,5 +1,5 @@
 ---
-title: Utilize CodeRabbit with Jira
+title: Jira Integration
 description: Integrate CodeRabbit with Jira.
 sidebar_label: Linked and Related Issues
 image: "/preview_meta.jpg"
@@ -26,22 +26,21 @@ image: "/preview_meta.jpg"
 
 After successfully integrating CodeRabbit with Jira, you gain the ability to link Jira issues directly to your pull requests.
 
-Linking Issues with Pull Requests
 To link a Jira issue to a pull request, simply include the Jira Issue ID in the pull request description. For instance:
 
 Jira issue: TEK-01
 
 This indicates that the pull request addresses a specific issue, such as fixing a bug. When the pull request is submitted with the associated Jira Issue ID, CodeRabbit automatically retrieves the corresponding issue and evaluates whether the pull request fulfills its objectives.
 
 :::info
-You can view the assessment outcome in the Walkthrough section.
+You can view the assessment outcome in the Walkthrough section of CodeRabbit's Review
 :::
 
 Upon posting the review findings, CodeRabbit provides details about the issue's objectives, confirms whether they were met, and offers additional explanations if needed.
 
 ### Finding Related Issues
 
-One of the key features of CodeRabbit's Jira integration is its ability to discover related issues. Leveraging RAG (Retrieval-Augmented Generation), CodeRabbit enhances its AI capabilities. RAG empowers AI models to incorporate external data sources beyond their training sets or predefined parameters, thereby enhancing their responses to given prompts.
+One of the key features of CodeRabbit's Jira integration is its ability to discover existing related jira issues addressed in the pull request. Leveraging RAG (Retrieval-Augmented Generation), CodeRabbit enhances its AI capabilities. RAG empowers AI models to incorporate external data sources beyond their training sets or predefined parameters, thereby enhancing their responses to given prompts.
 
 After integrating with Jira, CodeRabbit scans through open issues, indexing them for future reference. This means that pre-existing issues are retrieved, indexed into a Vector database, and subsequently searched for each new pull request.
 

docs/integrations/Linear/link.md

@@ -1,5 +1,5 @@
 ---
-title: Utilize CodeRabbit with Linear
+title: Linear Integration
 description: Utilize CodeRabbit with Linear.
 sidebar_label: Linked and Related Issues
 image: "/preview_meta.jpg"
@@ -21,3 +21,31 @@ image: "/preview_meta.jpg"
   <meta name="twitter:title" content="Utilize CodeRabbit with Linear" />
   <meta name="twitter:description" content="CodeRabbit: AI-powered Code Reviews" />
 </head>
+
+### Linking Issues
+
+After successfully integrating CodeRabbit with Linear, you gain the ability to link Linear issues directly to your pull requests.
+
+To link a Linear issue to a pull request, simply include the Linear Issue ID in the pull request description.
+
+For instance:
+
+Linear issue: **_COD-86_**
+
+![Linear Issue](../images/Linear/link/linear-linked-issue.png)
+
+This indicates that the pull request addresses a specific issue, such as adding a new feature. In this simple example, the issue created on linear specified to implement the division functionality for the simple calculator.
+
+When the pull request is submitted with the associated Linear Issue ID, CodeRabbit automatically retrieves the corresponding issue and evaluates whether the pull request fulfills its objectives.
+
+:::info
+You can view the assessment outcome in the Walkthrough section of CodeRabbit's Review.
+:::
+
+Upon posting the review findings, CodeRabbit provides details about the issue's objectives, confirms whether they were met, and offers additional explanations if needed. For example here the developer added the division functionality for the simple calculator in the pull request. CodeRabbit was able to find that issue, assess whether the pull request did indeed resolve the issue, and provided the assessment as seen below.
+
+![Linear Issue Response](../images/Linear/link/linear-assessment.png)
+
+### Finding Related Issues
+
+Another key feature of CodeRabbit's Linear integration is its ability to discover existing related Linear issues addressed in a pull request. Leveraging RAG (Retrieval-Augmented Generation) as described in [Jira Integration - Finding Related Issues](../Jira/link#finding-related-issues)