[Azure Mgmt Generator] Add return descriptions for generated pageable methods (#51967)

* Initial plan

* Fix pageable method return description generation in Azure Management Generator

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

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: ArcturusZhang <[email protected]>

Author: Copilot

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

@@ -12,6 +12,7 @@
 using Microsoft.TypeSpec.Generator.Primitives;
 using Microsoft.TypeSpec.Generator.Providers;
 using Microsoft.TypeSpec.Generator.Statements;
+using System;
 using System.Collections.Generic;
 using static Microsoft.TypeSpec.Generator.Snippets.Snippet;
 
@@ -84,12 +85,15 @@ protected MethodSignature CreateSignature()
                 ? new CSharpType(typeof(AsyncPageable<>), _actualItemType)
                 : new CSharpType(typeof(Pageable<>), _actualItemType);
 
+            // Generate return description for pageable methods
+            FormattableString returnDescription = $"A collection of {_actualItemType:C} that may take multiple service requests to iterate over.";
+
             return new MethodSignature(
                 _methodName,
                 _convenienceMethod.Signature.Description,
                 _convenienceMethod.Signature.Modifiers,
                 returnType,
-                _convenienceMethod.Signature.ReturnDescription,
+                returnDescription,
                 OperationMethodParameterHelper.GetOperationMethodParameters(_method, _contextualPath),
                 _convenienceMethod.Signature.Attributes,
                 _convenienceMethod.Signature.GenericArguments,