From 4cad482edcb6a0e5c2e6c0c68b575ac6bcd3677a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 9 Jul 2025 23:18:54 +0000
Subject: [PATCH 1/4] Initial plan


From a7e98cde735576a0b7a3ea2e5d9524e394e15f24 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Wed, 9 Jul 2025 23:26:23 +0000
Subject: [PATCH 2/4] Add deprecation warning to MSBuild package in
 Extensions.ApiDescription.Client

Co-authored-by: captainsafia <1857993+captainsafia@users.noreply.github.com>
---
 .../build/Microsoft.Extensions.ApiDescription.Client.props   | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
index 8f7fb3efce7f..a862a9c5385a 100644
--- a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
+++ b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
@@ -3,6 +3,11 @@
   <PropertyGroup>
     <_ApiDescriptionClientAssemblyPath>$(MSBuildThisFileDirectory)../tasks/netstandard2.0/Microsoft.Extensions.ApiDescription.Client.dll</_ApiDescriptionClientAssemblyPath>
   </PropertyGroup>
+  
+  <!-- Emit deprecation warning for this package -->
+  <Target Name="_WarnMicrosoftExtensionsApiDescriptionClientDeprecated" BeforeTargets="BeforeCompile;Build;Restore">
+    <Warning Text="The 'Microsoft.Extensions.ApiDescription.Client' package is deprecated and will be removed in a future release. Please consider migrating to alternative solutions for OpenAPI client code generation." />
+  </Target>
   <UsingTask TaskName="GetCurrentOpenApiReference" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />
   <UsingTask TaskName="GetOpenApiReferenceMetadata" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />
 

From 5bc86d4e04378d52bd3bbfffdddf4394686f7246 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 10 Jul 2025 00:08:54 +0000
Subject: [PATCH 3/4] Update deprecation warning text to include aka.ms link

Co-authored-by: captainsafia <1857993+captainsafia@users.noreply.github.com>
---
 .../src/build/Microsoft.Extensions.ApiDescription.Client.props  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
index a862a9c5385a..2beffaacf73c 100644
--- a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
+++ b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
@@ -6,7 +6,7 @@
   
   <!-- Emit deprecation warning for this package -->
   <Target Name="_WarnMicrosoftExtensionsApiDescriptionClientDeprecated" BeforeTargets="BeforeCompile;Build;Restore">
-    <Warning Text="The 'Microsoft.Extensions.ApiDescription.Client' package is deprecated and will be removed in a future release. Please consider migrating to alternative solutions for OpenAPI client code generation." />
+    <Warning Text="The 'Microsoft.Extensions.ApiDescription.Client' package is deprecated and will be removed in a future release. For more information, see aka.ms/aspnet/deprecate/001." />
   </Target>
   <UsingTask TaskName="GetCurrentOpenApiReference" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />
   <UsingTask TaskName="GetOpenApiReferenceMetadata" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />

From 0b052433dee4825c5b0261562a6810f2e9d285a1 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 10 Jul 2025 00:15:04 +0000
Subject: [PATCH 4/4] Add warning code and help link to deprecation warning

Co-authored-by: captainsafia <1857993+captainsafia@users.noreply.github.com>
---
 .../src/build/Microsoft.Extensions.ApiDescription.Client.props  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
index 2beffaacf73c..381389465acb 100644
--- a/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
+++ b/src/Tools/Extensions.ApiDescription.Client/src/build/Microsoft.Extensions.ApiDescription.Client.props
@@ -6,7 +6,7 @@
   
   <!-- Emit deprecation warning for this package -->
   <Target Name="_WarnMicrosoftExtensionsApiDescriptionClientDeprecated" BeforeTargets="BeforeCompile;Build;Restore">
-    <Warning Text="The 'Microsoft.Extensions.ApiDescription.Client' package is deprecated and will be removed in a future release. For more information, see aka.ms/aspnet/deprecate/001." />
+    <Warning Code="ASPDEPR001" Text="The 'Microsoft.Extensions.ApiDescription.Client' package is deprecated and will be removed in a future release." HelpLink="https://aka.ms/aspnet/deprecate/001" />
   </Target>
   <UsingTask TaskName="GetCurrentOpenApiReference" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />
   <UsingTask TaskName="GetOpenApiReferenceMetadata" AssemblyFile="$(_ApiDescriptionClientAssemblyPath)" />