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/importers/linear.mdx b/docs/importers/linear.mdx new file mode 100644 index 0000000..14911fe --- /dev/null +++ b/docs/importers/linear.mdx @@ -0,0 +1,86 @@ +--- +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 +> **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#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#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#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#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#center) + +9. **Map states** + Map **Linear states** to their equivalent **Plane states**. + ![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#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#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#center) + +### 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#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 055317e..da7ccb2 100644 --- a/sidebars.ts +++ b/sidebars.ts @@ -147,9 +147,10 @@ const sidebars: SidebarsConfig = { collapsed: true, label: 'Importers', items: [ + 'importers/overview', 'importers/asana', 'importers/jira-imp', - + 'importers/linear' ], }, {