Rpatel/docs jira integration

docs/docs.json

@@ -34,6 +34,7 @@
 							"integrations/github",
 							"integrations/slack",
 							"integrations/linear",
+							"integrations/jira",
 							"integrations/notion",
 							"integrations/figma",
 							"integrations/circleci",

docs/integrations/jira.mdx

@@ -0,0 +1,58 @@
+---
+title: "Jira Integration"
+sidebarTitle: "Jira"
+icon: "jira"
+---
+
+import { COMMUNITY_SLACK_URL } from "/snippets/links.mdx";
+
+Integrate Codegen with your Jira workspace to allow agents to interact with issues, manage projects, and keep your team updated.
+
+<img src="/images/jira.png" className="rounded-lg" />
+
+<Note>
+  The Jira integration is currently in <b>beta</b>. Please reach out in the <a href={COMMUNITY_SLACK_URL}>community</a> to have it enabled for your Codegen account.
+</Note>
+
+## Step-by-Step Setup Guide
+
+Follow these steps to successfully connect Codegen to your Jira workspace:
+
+### 1. Create a Dedicated Jira User for Codegen
+- In your Jira workspace, create a new user account specifically for Codegen.
+- **Email:** Use an address with `codegen` in it, like `yourname+codegen@company_domain.com` or `codegen@company_domain.com`.
+- **Name:** Set the user's name to **Codegen**. This makes it easy to identify actions performed by Codegen in Jira.
+
+### 2. Authorize Codegen with the New Jira User
+- Log in to Jira as the new Codegen user.
+- Go to [Codegen's Jira Integration page](https://codegen.com/integrations/jira).
+- Click **Connect Jira Workspace** and complete the OAuth flow **using the Codegen Jira user** you just created.
+
+<Warning>
+  Make sure you are logged in as the Codegen Jira user when authorizing access. This is to ensure Codegen acts on behalf of the new user and not your personal account.
+</Warning>
+
+### 3. Switch Back to Your Own Jira Account
+- After connecting, log out of the Codegen Jira user in Jira.
+- Log back in with your personal Jira account.
+
+### 4. Use Codegen in Your Workflow
+- On any Jira ticket, `@mention` the Codegen user (e.g., `@Codegen`) to assign or notify Codegen about the issue.
+- Codegen will interact with the ticket, update statuses, add comments, and link PRs as needed.
+
+## Capabilities
+
+The Jira integration provides read and write access, enabling agents to manage tasks effectively:
+
+- **Read Access:** Fetch issue details, read comments, view project status, list team members.
+- **Write Access:** Update issue status (e.g., to "In Progress", "Done"), add comments, link GitHub PRs to issues, create new issues, assign tasks.
+
+## How Agents Use Jira
+
+Agents use the Jira integration to streamline project management:
+
+- **Track Work:** Automatically update the status of issues they are working on.
+- **Link Code:** Connect implemented changes (GitHub PRs) directly to the relevant Jira issue.
+- **Provide Updates:** Post comments on issues with progress reports, results, or questions.
+- **Create Tasks:** Generate new issues for follow-up work, bugs discovered, or sub-tasks.
+

docs/integrations/linear.mdx

@@ -6,7 +6,7 @@ icon: "file-lines"
 
 Linear is designed to orchestrate teams of humans and agents working together. It's the most efficient way to track progress and scale teams of agents to tackle large, complex tasks. Codegen can take a first pass at virtually any issue, breaking down work and making meaningful progress before human review. We recommend letting Codegen handle the initial exploration and implementation of most tasks.
 
-<img src="/images/linear.png" />
+<img src="/images/linear.png" className="rounded-lg" />
 
 ## Installation
 

docs/integrations/slack.mdx

@@ -6,7 +6,7 @@ icon: "slack"
 
 Connect Codegen to your Slack workspace to enable seamless communication between agents and your team.
 
-<img src="/images/slack.png" />
+<img src="/images/slack.png" className="rounded-lg" />
 
 Slack is the most fluid way to communicate with Codegen. Simply tag @codegen in any channel to collaborate directly and give it tasks that leverage all your other integrations. As an agent, Codegen can seamlessly work across platforms—from GitHub to Linear to your databases—all initiated from Slack. We recommend Slack as the lowest barrier entry point for all users.