[Azure Mgmt Generator] Fix XML documentation line breaks for resource providers (Azure#51917)

* Initial plan

* Initial assessment of XML documentation line break issue

Co-authored-by: ArcturusZhang <[email protected]>

* Fix XML documentation line breaks in management generator providers

Co-authored-by: ArcturusZhang <[email protected]>

* Update MockableResourceProvider description to requested format

Co-authored-by: ArcturusZhang <[email protected]>

---------

Co-authored-by: Copilot <[email protected]>
Co-authored-by: ArcturusZhang <[email protected]>

Author: Copilot

eng/packages/http-client-csharp-mgmt/eng/scripts/Generate.ps1

@@ -14,6 +14,7 @@
 using Microsoft.TypeSpec.Generator.Primitives;
 using Microsoft.TypeSpec.Generator.Providers;
 using Microsoft.TypeSpec.Generator.Statements;
+using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Linq;
@@ -111,6 +112,8 @@ private static Dictionary<InputClient, RestClientInfo> BuildRestClientInfos(
 
         protected override string BuildName() => $"Mockable{ManagementClientGenerator.Instance.TypeFactory.ResourceProviderName}{ArmCoreType.Name}";
 
+        protected override FormattableString BuildDescription() => $"A class to add extension methods to {ArmCoreType:C}.";
+
         protected override string BuildRelativeFilePath() => Path.Combine("src", "Generated", "Extensions", $"{Name}.cs");
 
         protected override CSharpType? BuildBaseType() => typeof(ArmResource);

eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/MockableResourceProvider.cs

@@ -87,7 +87,7 @@ private ResourceClientProvider(string resourceName, InputModelType model, IReadO
         protected override string BuildName() => ResourceName.EndsWith("Resource") ? ResourceName : $"{ResourceName}Resource";
 
         // TODO: Add support for getting parent resource from a resource
-        protected override FormattableString BuildDescription() => $"A class representing a {ResourceName} along with the instance operations that can be performed on it. If you have a {typeof(ResourceIdentifier):C} you can construct a {Type:C} from an instance of {typeof(ArmClient):C} using the GetResource method. Otherwise you can get one from its parent resource (TODO: add parent resource information).";
+        protected override FormattableString BuildDescription() => $"A class representing a {ResourceName} along with the instance operations that can be performed on it.\nIf you have a {typeof(ResourceIdentifier):C} you can construct a {Type:C} from an instance of {typeof(ArmClient):C} using the GetResource method.\nOtherwise you can get one from its parent resource (TODO: add parent resource information).";
 
         private OperationSourceProvider? _source;
         internal OperationSourceProvider Source => _source ??= new OperationSourceProvider(this);

eng/packages/http-client-csharp-mgmt/generator/Azure.Generator.Management/src/Providers/ResourceClientProvider.cs

@@ -111,7 +111,7 @@ private static void InitializeMethods(
         protected override string BuildName() => $"{ResourceName}Collection";
 
         // TODO: Add support for getting parent resource from a resource collection
-        protected override FormattableString BuildDescription() => $"A class representing a collection of {_resource.Type:C} and their operations. Each {_resource.Type:C} in the collection will belong to the same instance of a parent resource (TODO: add parent resource information). To get a {Type:C} instance call the Get{ResourceName.Pluralize()} method from an instance of the parent resource.";
+        protected override FormattableString BuildDescription() => $"A class representing a collection of {_resource.Type:C} and their operations.\nEach {_resource.Type:C} in the collection will belong to the same instance of a parent resource (TODO: add parent resource information).\nTo get a {Type:C} instance call the Get{ResourceName.Pluralize()} method from an instance of the parent resource.";
 
         protected override string BuildRelativeFilePath() => Path.Combine("src", "Generated", $"{Name}.cs");