Add Jira docs, update Linear docs (#128)

* Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor * Documentation edits made through Mintlify web editor * lint * remove dupe * fix --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> Co-authored-by: andrewblaney <[email protected]>
team-plain · Nov 6, 2024 · 53c2ef4 · 53c2ef4
1 parent a740231
commit 53c2ef4
Show file tree

Hide file tree

Showing 3 changed files with 20 additions and 4 deletions.
diff --git a/integrations/jira.mdx b/integrations/jira.mdx
@@ -0,0 +1,15 @@
+---
+title: 'Jira integration'
+---
+
+To easily keep track of feature requests and bugs reported by your customers in Plain, you can connect your Jira workspace to Plain.
+
+This lets you easily link a Jira issue to a thread, and ensures you're always prompted to reply to a customer when their bug is fixed or feature request is shipped. 
+
+To do this, head to Settings → Jira integration (under the Integrations section) and connect your workspace.
+
+Once you've linked your Jira workspace to Plain, you can create a Jira issue (or link an existing Jira issue) directly to a customer request in the sidebar on the right hand side of a thread – or by pressing the shortcut: `i`. 
+
+Once a Jira issue is linked, the thread will move back to Close the loop when the Jira issue is completed, canceled or deleted.
+
+**Coming soon:** you'll be able to get a ranked view of your top customer requests from Jira directly in Plain. You'll also be able to dig into each request, to understand which customers requested each feature, the tier breakdown of these customers and when the request was initially made. Please reach out to us if you'd like a demo of this feature. 
diff --git a/integrations/linear.mdx b/integrations/linear.mdx
@@ -6,12 +6,12 @@ title: 'Linear integration'
 
 To easily keep track of feature requests and bugs reported in Plain, you can connect your Linear workspace with Plain.
 
-This lets you easily link a Linear issue to a thread.
+This lets you easily link a Linear issue to a thread – and ensures you're always prompted to reply to a customer when their bug is fixed or feature request is shipped. 
 
 To do this, head to **Settings** → **Linear integration** and connect your workspace.
 
-Once this set-up is done, you can add a Linear issue from the right hand side of a thread or by pressing the shortcut `i`.
+Once you've linked your Linear workspace to Plain, you can create a Linear issue (or link an existing Linear issue) directly to a customer request in the sidebar on the right hand side of a thread – or by pressing the shortcut:`i`.
 
-Once a Linear issue is linked, the thread will move back to `Todo` when the Linear issue is completed or cancelled.
+Once a Linear issue is linked, the thread will move back to `Close the loop` when the Linear issue is completed or canceled.
 
-This means that you can update customers when a bug or feature request that they reported has been fixed.
+Once you connect your Linear account and start linking issues to customer requests, you'll get access to a new Linear issues page in Plain – where you'll be able to get a ranked view of your top customer requests from Linear directly in Plain. You can also dig into each request, to understand which customers requested each feature, the tier breakdown of these customers and when the request was initially made.
diff --git a/mint.json b/mint.json
@@ -125,6 +125,7 @@
 			"group": "Integrations",
 			"pages": [
 				"integrations/linear",
+				"integrations/jira",
 				"integrations/salesforce",
 				"integrations/zendesk",
 				"integrations/discourse",