diff --git a/assets/images/help/issues/migrate-option.png b/assets/images/help/issues/migrate-option.png new file mode 100644 index 0000000000..20b150bcfe Binary files /dev/null and b/assets/images/help/issues/migrate-option.png differ diff --git a/assets/images/help/issues/migrate-start.png b/assets/images/help/issues/migrate-start.png new file mode 100644 index 0000000000..0a4120cb70 Binary files /dev/null and b/assets/images/help/issues/migrate-start.png differ diff --git a/assets/images/help/issues/migrate-to-beta.png b/assets/images/help/issues/migrate-to-beta.png new file mode 100644 index 0000000000..9b6ab1174b Binary files /dev/null and b/assets/images/help/issues/migrate-to-beta.png differ diff --git a/assets/images/help/issues/projects-classic-org.png b/assets/images/help/issues/projects-classic-org.png new file mode 100644 index 0000000000..d2b788f956 Binary files /dev/null and b/assets/images/help/issues/projects-classic-org.png differ diff --git a/assets/images/help/issues/projects-classic-user.png b/assets/images/help/issues/projects-classic-user.png new file mode 100644 index 0000000000..0e32219440 Binary files /dev/null and b/assets/images/help/issues/projects-classic-user.png differ diff --git a/content/issues/trying-out-the-new-projects-experience/index.md b/content/issues/trying-out-the-new-projects-experience/index.md index 25f225b0c4..9c5acfe3b4 100644 --- a/content/issues/trying-out-the-new-projects-experience/index.md +++ b/content/issues/trying-out-the-new-projects-experience/index.md @@ -12,6 +12,7 @@ children: - /about-projects - /quickstart - /creating-a-project + - /migrating-your-project - /managing-iterations - /customizing-your-project-views - /filtering-projects diff --git a/content/issues/trying-out-the-new-projects-experience/migrating-your-project.md b/content/issues/trying-out-the-new-projects-experience/migrating-your-project.md new file mode 100644 index 0000000000..ec4fa1c2b2 --- /dev/null +++ b/content/issues/trying-out-the-new-projects-experience/migrating-your-project.md @@ -0,0 +1,65 @@ +--- +title: Migrating your project to Projects (beta) +intro: 'You can migrate your projects from the old projects experience to Projects (beta).' +allowTitleToDifferFromFilename: true +miniTocMaxHeadingLevel: 2 +versions: + fpt: '*' + ghec: '*' +topics: + - Projects + - Organizations +--- + +{% note %} + +**Notes:** + +- Projects (beta) is currently in public beta and subject to change. +- If the project you are migrating contains more than 1200 items, open issues will be prioritized followed by open pull requests and then notes. Remaining space will be used for closed issues, merged pull requested, and closed pull requests. Items that cannot be migrated due to this limit will be moved to the archive. If the archive limit of 10,000 items is reached, additional items will not be migrated. +- Note cards are converted to draft issues, and the contents are saved to the body of the draft issue. If information appears to be missing, make any hidden fields visible. For more information, see "[Showing and hiding fields](/issues/trying-out-the-new-projects-experience/customizing-your-project-views#showing-and-hiding-fields)." +- Automation will not be migrated. +- Triage, archive, and activity will not be migrated. +- After migration, the new migrated project and old project will not be kept in sync. + +{% endnote %} + +## About project migration + +You can migrate your project boards to the all new projects (beta) experience and try out tables, multiple views, new automation options, and powerful field types. For more information, see "[About projects (beta)](/issues/trying-out-the-new-projects-experience/about-projects)." + +## Migrating an organization project board + +{% data reusables.projects.enable-migration %} +{% data reusables.profile.access_org %} +{% data reusables.user-settings.access_org %} +{% data reusables.organizations.organization-wide-project %} +1. On the left, click **Projects (classic)**. + ![Screenshot showing Projects (classic) menu option}](/assets/images/help/issues/projects-classic-org.png) +{% data reusables.projects.migrate-project-steps %} + +## Migrating a user project board + +{% data reusables.projects.enable-migration %} +{% data reusables.profile.access_profile %} +1. On the top of your profile page, in the main navigation, click {% octicon "project" aria-label="The project board icon" %} **Projects**. +![Project tab](/assets/images/help/projects/user-projects-tab.png) +1. Above the list of projects, click **Projects (classic)**. + ![Screenshot showing Projects (classic) menu option}](/assets/images/help/issues/projects-classic-user.png) +{% data reusables.projects.migrate-project-steps %} + +## Migrating a repository project board + +{% note %} + +**Note:** Projects (beta) does not support repository level projects. When you migrate a repository project board, it will migrate to either the organization or personal account that owns the repository project, and the migrated project will be pinned to the original repository. + +{% endnote %} + +{% data reusables.projects.enable-migration %} +{% data reusables.repositories.navigate-to-repo %} +1. Under your repository name, click {% octicon "project" aria-label="The project board icon" %} **Projects**. +![Project tab](/assets/images/help/projects/repo-tabs-projects.png) +1. Click **Projects (classic)**. + ![Screenshot showing Projects (classic) menu option}](/assets/images/help/issues/projects-classic-org.png) +{% data reusables.projects.migrate-project-steps %} \ No newline at end of file diff --git a/data/reusables/projects/enable-migration.md b/data/reusables/projects/enable-migration.md new file mode 100644 index 0000000000..37cb912f71 --- /dev/null +++ b/data/reusables/projects/enable-migration.md @@ -0,0 +1 @@ +1. Enable "Project migration" in feature preview. For more information, see "[Exploring early access releases with feature preview](/get-started/using-github/exploring-early-access-releases-with-feature-preview)." \ No newline at end of file diff --git a/data/reusables/projects/migrate-project-steps.md b/data/reusables/projects/migrate-project-steps.md new file mode 100644 index 0000000000..18a9f177f1 --- /dev/null +++ b/data/reusables/projects/migrate-project-steps.md @@ -0,0 +1,8 @@ +1. Next to the project you want to migrate, click {% octicon "kebab-horizontal" aria-label="The menu icon" %} to open the menu. +1. In the menu, click **Migrate to beta**. + ![Screenshot showing migrate to beta option](/assets/images/help/issues/migrate-to-beta.png) +1. In the the popup, select what you want to happen to the project after it is migrated. We recommend selecting "Close the old project" so it's clear which project is in use. + ![Screenshot showing migrate to beta option](/assets/images/help/issues/migrate-option.png) +1. In the bottom right of the popup, click **Start migration**. + ![Screenshot showing migrate to beta option](/assets/images/help/issues/migrate-start.png) +1. When the migration is complete, the new migrated project will open in a new tab. \ No newline at end of file diff --git a/data/reusables/projects/project_boards_old.md b/data/reusables/projects/project_boards_old.md index 3dcb812342..b801c67119 100644 --- a/data/reusables/projects/project_boards_old.md +++ b/data/reusables/projects/project_boards_old.md @@ -2,7 +2,7 @@ {% note %} -**Note:** Projects (beta), the all-new projects experience, is now available. For more information about projects (beta), see "[About projects (beta)](/issues/trying-out-the-new-projects-experience/about-projects)." +**Note:** Projects (beta), the all-new projects experience, is now available. For more information about projects (beta), see "[About projects (beta)](/issues/trying-out-the-new-projects-experience/about-projects)" and for information about migrating your project, see "[Migrating your project to Projects (beta)](/issues/trying-out-the-new-projects-experience/migrating-your-project)." {% endnote %} {% endif %}