Add Team Discussions migration tooling and deprecation announcement t…

…o docs (github#33967)
mohammadmn82 · Feb 8, 2023 · 87d68a2 · 87d68a2
1 parent 587ef88
commit 87d68a2
Show file tree

Hide file tree

Showing 10 changed files with 43 additions and 0 deletions.
diff --git a/content/organizations/collaborating-with-your-team/about-team-discussions.md b/content/organizations/collaborating-with-your-team/about-team-discussions.md
@@ -13,6 +13,9 @@ versions:
 topics:
   - Community
 ---
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
 
 {% data reusables.organizations.team-discussions-purpose %}
 

diff --git a/content/organizations/collaborating-with-your-team/creating-a-team-discussion.md b/content/organizations/collaborating-with-your-team/creating-a-team-discussion.md
@@ -15,6 +15,10 @@ topics:
 shortTitle: Create a team discussion
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 {% data reusables.organizations.team-discussions-permissions %} For more information, see "[About team discussions](/organizations/collaborating-with-your-team/about-team-discussions)."
 
 {% data reusables.profile.access_org %}

diff --git a/...nizations/collaborating-with-your-team/editing-or-deleting-a-team-discussion.md b/...nizations/collaborating-with-your-team/editing-or-deleting-a-team-discussion.md
@@ -15,6 +15,10 @@ topics:
 shortTitle: Manage a team discussion
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 {% data reusables.profile.access_org %}
 {% data reusables.user-settings.access_org %}
 {% data reusables.organizations.specific_team %}

diff --git a/content/organizations/collaborating-with-your-team/index.md b/content/organizations/collaborating-with-your-team/index.md
@@ -20,3 +20,6 @@ children:
 shortTitle: Collaborate with your team
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
diff --git a/content/organizations/collaborating-with-your-team/pinning-a-team-discussion.md b/content/organizations/collaborating-with-your-team/pinning-a-team-discussion.md
@@ -14,6 +14,10 @@ topics:
   - Community
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 {% data reusables.profile.access_org %}
 {% data reusables.user-settings.access_org %}
 {% data reusables.organizations.specific_team %}

diff --git a/...ganizing-members-into-teams/disabling-team-discussions-for-your-organization.md b/...ganizing-members-into-teams/disabling-team-discussions-for-your-organization.md
@@ -15,6 +15,10 @@ topics:
 shortTitle: Disable team discussions
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 {% data reusables.organizations.team-discussions-default %} For more information on team discussions, see "[About team discussions](/organizations/collaborating-with-your-team/about-team-discussions)."
 
 {% data reusables.profile.access_org %}

diff --git a/content/rest/teams/discussion-comments.md b/content/rest/teams/discussion-comments.md
@@ -13,6 +13,10 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 ## About team discussion comments
 
 Any member of the team's [organization](/rest/reference/orgs) can create and read comments on a public discussion. For more details, see "[About team discussions](/organizations/collaborating-with-your-team/about-team-discussions/)." 

diff --git a/content/rest/teams/discussions.md b/content/rest/teams/discussions.md
@@ -13,6 +13,10 @@ topics:
 miniTocMaxHeadingLevel: 3
 ---
 
+{% ifversion team-discussions-migration %}
+{% data reusables.organizations.team-discussions-migration %}
+{% endif %}
+
 ## About team discussions
 
 You can use team discussions to have conversations that are not specific to a repository or project. Any member of the team's [organization](/rest/reference/orgs) can create and read public discussion posts. For more details, see "[About team discussions](//organizations/collaborating-with-your-team/about-team-discussions/)." To learn more about commenting on a discussion post, see "[Team discussion comments](/rest/teams/discussion-comments)."

diff --git a/data/features/team-discussions-migration.yml b/data/features/team-discussions-migration.yml
@@ -0,0 +1,5 @@
+# Reference: #8243
+# Team Discussions migration and eventual deprecation announcement
+versions:
+  fpt: '*'
+  ghec: '*'
diff --git a/data/reusables/organizations/team-discussions-migration.md b/data/reusables/organizations/team-discussions-migration.md
@@ -0,0 +1,8 @@
+
+{% note %}
+
+**Note**: Team Discussions will be deprecated on **May 8, 2023** in favor of GitHub Discussions. You can transfer your existing team discussions to a repository's discussions by using a migration tool that allows team admins to migrate both public and private team discussions. Click the "Transfer" button in the banner at the top of your team discussions page, then choose the repository in your organization that you want to migrate the discussions to. 
+
+For more information on GitHub Discussions, see "[About discussions](/discussions/collaborating-with-your-community-using-discussions/about-discussions)."
+
+{% endnote %}