From 73590aa56c15f9c750585302e58013a942bce854 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Mon, 9 Dec 2024 19:24:30 +0530 Subject: [PATCH 1/2] Added Linear importer page --- docs/plane-importers/linear-importer.mdx | 82 ++++++++++++++++++++++++ sidebars.ts | 2 +- 2 files changed, 83 insertions(+), 1 deletion(-) create mode 100644 docs/plane-importers/linear-importer.mdx diff --git a/docs/plane-importers/linear-importer.mdx b/docs/plane-importers/linear-importer.mdx new file mode 100644 index 0000000..f26cf67 --- /dev/null +++ b/docs/plane-importers/linear-importer.mdx @@ -0,0 +1,82 @@ +--- +title: Linear +--- + +# Import your Linear data to Plane + +With the Linear importer, you can easily import issues, states, labels, priorities and user data from Linear to Plane and continue managing your existing projects. + +## Import from Linear +> **Role**: Workspace admins + +To import Linear issues to a Plane project, follow these steps: +1. Click the **∨** icon next to your workspace name on the sidebar and select **Workspace settings**. + +2. Select **Imports** on the right pane and click the **Import** button in the Linear section. + ![Import Linear](https://media.docs.plane.so/importers/linear/import-linear.webp) + +4. In the **Linear to Plane Migration Assistant** screen, enter your **Personal Access Token** to allow Plane access to your Linear account. + ![Connect Linear](https://media.docs.plane.so/importers/linear/linear-plane-migration-assistant.webp) + +5. Click the **Connect Linear** button to link the accounts. + +6. Click the **Import** button in the **Imports** section. + ![Import Linear data](https://media.docs.plane.so/importers/linear/import-linear-data.webp) + +7. **Configure Plane** + Select the Plane project where you want to import your Linear data and and click **Next**. + ![Configure Plane](https://media.docs.plane.so/importers/linear/configure-plane.webp) + +8. **Configure Linear** + Choose the Linear team from where you want to import data. + ![Configure Linear](https://media.docs.plane.so/importers/linear/configure-linear.webp) + +9. **Map states** + Map **Linear states** to their equivalent **Plane states**. + ![Map states](https://media.docs.plane.so/importers/linear/map-states.webp) + +10. **Summary** + Review the mappings and make any changes if needed. Click **Back** to adjust, or click **Confirm** to start the migration. + ![Review mappings](https://media.docs.plane.so/importers/linear/import-summary.webp) + +11. The data migration begins and takes a few minutes to complete depending on the number of issues in your Linear workspace. + ![Migration complete](https://media.docs.plane.so/importers/linear/import-complete.webp) + +12. Once it's done, go to **Issues** in your Plane project to confirm that the data import is successful. + ![Verify import](https://media.docs.plane.so/importers/linear/verify-import.webp) + +### Imported entities + +Here’s a quick look at what gets imported during the migration from Linear to Plane: + +| Linear | Plane | Notes| +|--------------| ------------------- |---- | +| Labels | Labels | | +| Status | States | | +| Issue priorities | Priorities | | +| Users | Users | | +| Issues | Issues | | +| Relations | Parent | Includes only parent-child relationships | +| Issue comments | Issue comments |Includes username and timestamp. If you skip user import during migration, comments will show the name of the user who performed the migration.| +| Issue attachments | Issue attachments | | +| Reporter | Created by | | +| Created | Created at | | +| Assignee | Assignees | If you skip user import during migration, this will be blank.| +| Issue types | Labels \| Prefix in Issue title | | +| Images in the Issue description | Images in the Issue description | | +| Summary | Issue title | | +| Start date | Start date | | +| Due date | Due date | | +| Linked Issues | Links | Includes backlinks to the original Linear issue.| +| Sprint | Cycles | Includes the issues, start and end date. | +| Components | Modules | Includes the issues. | + +## Sync Linear to Plane + +After the import, if there are any new or updated issues in Linear, you can easily sync these changes to Plane: + +1. Go to **Workspace settings**. +2. Select **Imports** on the right pane. +3. Click the **Re run** button next to the project you want to sync. + ![Sync Linear](https://media.docs.plane.so/importers/Linear/rerun-import.webp) + diff --git a/sidebars.ts b/sidebars.ts index 8078edc..354d6e0 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -131,8 +131,8 @@ const sidebars: SidebarsConfig = { collapsed: false, label: 'Importers', items: [ - 'plane-importers/github-imp', 'plane-importers/jira-imp', + 'plane-importers/linear-importer', ], }, { From b53b0777f8ee94766d862530a2c4274f3fb4d6a2 Mon Sep 17 00:00:00 2001 From: danciaclara Date: Wed, 29 Jan 2025 19:14:46 +0530 Subject: [PATCH 2/2] final changes --- docs/importers/asana.mdx | 2 +- docs/importers/jira-imp.mdx | 5 ++-- .../linear.mdx} | 24 +++++++++++-------- .../overview.mdx | 12 +++++----- sidebars.ts | 1 + 5 files changed, 25 insertions(+), 19 deletions(-) rename docs/{plane-importers/linear-importer.mdx => importers/linear.mdx} (86%) rename docs/{plane-importers => importers}/overview.mdx (78%) diff --git a/docs/importers/asana.mdx b/docs/importers/asana.mdx index bce158f..11817be 100644 --- a/docs/importers/asana.mdx +++ b/docs/importers/asana.mdx @@ -5,7 +5,7 @@ title: Asana # Import your Asana data to Plane :::info -The Asana importer is currently available under a feature flag. Contact our support team if you’d like to try it out. +The Asana importer is currently available under a feature flag. Contact us to try it out. ::: With the Asana importer, you can easily import issues, states, labels, priorities and user data from Asana to Plane and continue managing your existing projects. diff --git a/docs/importers/jira-imp.mdx b/docs/importers/jira-imp.mdx index 4e81dad..9ffe42f 100644 --- a/docs/importers/jira-imp.mdx +++ b/docs/importers/jira-imp.mdx @@ -5,7 +5,7 @@ title: Jira # Import your Jira data to Plane :::info -The Jira importer is currently available under a feature flag. Contact our support team if you’d like to try it out. +The Jira importer is currently available under a feature flag. Contact us to try it out. ::: With the Jira importer, you can easily import issues, states, labels, priorities and user data from Jira to Plane and continue managing your existing projects. @@ -20,11 +20,12 @@ To import Jira issues to a Plane project, follow these steps: ![Import from Jira](https://media.docs.plane.so/importers/jira/import-jira.webp#center) 4. In the **Jira to Plane Migration Assistant** screen, enter your **Personal Access Token**, **User email** and the **Jira domain** to allow Plane access to your Atlassian account. + ![Connect Jira](https://media.docs.plane.so/importers/jira/jira-plane-migration-assitant.webp#center) 5. Click the **Connect Jira** button to link the accounts. 6. Click the **Import** button. - ![Connect Jira](https://media.docs.plane.so/importers/jira/import-jira-data.webp#center) + ![Import Jira](https://media.docs.plane.so/importers/jira/import-jira-data.webp#center) 7. **Configure Plane** Select the Plane project where you want to import your Jira data and and click **Next**. diff --git a/docs/plane-importers/linear-importer.mdx b/docs/importers/linear.mdx similarity index 86% rename from docs/plane-importers/linear-importer.mdx rename to docs/importers/linear.mdx index f26cf67..14911fe 100644 --- a/docs/plane-importers/linear-importer.mdx +++ b/docs/importers/linear.mdx @@ -4,6 +4,10 @@ title: Linear # Import your Linear data to Plane +:::info +The Linear importer is currently available under a feature flag. Contact us to try it out. +::: + With the Linear importer, you can easily import issues, states, labels, priorities and user data from Linear to Plane and continue managing your existing projects. ## Import from Linear @@ -13,37 +17,37 @@ To import Linear issues to a Plane project, follow these steps: 1. Click the **∨** icon next to your workspace name on the sidebar and select **Workspace settings**. 2. Select **Imports** on the right pane and click the **Import** button in the Linear section. - ![Import Linear](https://media.docs.plane.so/importers/linear/import-linear.webp) + ![Import Linear](https://media.docs.plane.so/importers/linear/import-linear.webp#center) 4. In the **Linear to Plane Migration Assistant** screen, enter your **Personal Access Token** to allow Plane access to your Linear account. - ![Connect Linear](https://media.docs.plane.so/importers/linear/linear-plane-migration-assistant.webp) + ![Connect Linear](https://media.docs.plane.so/importers/linear/linear-plane-migration-assistant.webp#center) 5. Click the **Connect Linear** button to link the accounts. 6. Click the **Import** button in the **Imports** section. - ![Import Linear data](https://media.docs.plane.so/importers/linear/import-linear-data.webp) + ![Import Linear data](https://media.docs.plane.so/importers/linear/import-linear-data.webp#center) 7. **Configure Plane** Select the Plane project where you want to import your Linear data and and click **Next**. - ![Configure Plane](https://media.docs.plane.so/importers/linear/configure-plane.webp) + ![Configure Plane](https://media.docs.plane.so/importers/linear/configure-plane.webp#center) 8. **Configure Linear** Choose the Linear team from where you want to import data. - ![Configure Linear](https://media.docs.plane.so/importers/linear/configure-linear.webp) + ![Configure Linear](https://media.docs.plane.so/importers/linear/configure-linear.webp#center) 9. **Map states** Map **Linear states** to their equivalent **Plane states**. - ![Map states](https://media.docs.plane.so/importers/linear/map-states.webp) + ![Map states](https://media.docs.plane.so/importers/linear/map-states.webp#center) 10. **Summary** Review the mappings and make any changes if needed. Click **Back** to adjust, or click **Confirm** to start the migration. - ![Review mappings](https://media.docs.plane.so/importers/linear/import-summary.webp) + ![Review mappings](https://media.docs.plane.so/importers/linear/import-summary.webp#center) 11. The data migration begins and takes a few minutes to complete depending on the number of issues in your Linear workspace. - ![Migration complete](https://media.docs.plane.so/importers/linear/import-complete.webp) + ![Migration complete](https://media.docs.plane.so/importers/linear/import-complete.webp#center) 12. Once it's done, go to **Issues** in your Plane project to confirm that the data import is successful. - ![Verify import](https://media.docs.plane.so/importers/linear/verify-import.webp) + ![Verify import](https://media.docs.plane.so/importers/linear/verify-import.webp#center) ### Imported entities @@ -78,5 +82,5 @@ After the import, if there are any new or updated issues in Linear, you can easi 1. Go to **Workspace settings**. 2. Select **Imports** on the right pane. 3. Click the **Re run** button next to the project you want to sync. - ![Sync Linear](https://media.docs.plane.so/importers/Linear/rerun-import.webp) + ![Sync Linear](https://media.docs.plane.so/importers/linear/rerun-import.webp#center) diff --git a/docs/plane-importers/overview.mdx b/docs/importers/overview.mdx similarity index 78% rename from docs/plane-importers/overview.mdx rename to docs/importers/overview.mdx index 49cba1a..f329ebf 100644 --- a/docs/plane-importers/overview.mdx +++ b/docs/importers/overview.mdx @@ -10,16 +10,16 @@ Switching tools shouldn’t mean starting over. With Plane importers, you can ef - } href="/plane-integrations/asana-importer"> - Integrate Plane with Github to automatically capture issues from github. We will expand this to support sync of PRs with Plane issues. + } href="/importers/asana"> + Migrate tasks from Asana to Plane, keeping your workflow intact and organized. - - Integrate Plane with Github to automatically capture issues from github. We will expand this to support sync of PRs with Plane issues. + + Import boards from Jira into Plane, streamlining your project setup. - } href="/plane-integrations/slack-importer"> - Integrate Plane with Slack to forward issue updates from plane to github. We will expand this to support creating issues from slack soon. + } href="/importers/linear"> + Bring Linear tasks into Plane, ensuring smooth transitions and continued progress. diff --git a/sidebars.ts b/sidebars.ts index 858a136..da7ccb2 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -147,6 +147,7 @@ const sidebars: SidebarsConfig = { collapsed: true, label: 'Importers', items: [ + 'importers/overview', 'importers/asana', 'importers/jira-imp', 'importers/linear'