fix: Fixed some docs warnings.

src/libs/Directory.Build.props

@@ -39,7 +39,7 @@
   </ItemGroup>
 
   <PropertyGroup Label="Versioning">
-    <Version>0.6.2</Version>
+    <Version>0.6.3</Version>
     <MinVerMinimumMajorMinor>0.1</MinVerMinimumMajorMinor>
     <MinVerTagPrefix>v</MinVerTagPrefix>
     <MinVerDefaultPreReleaseIdentifiers>dev</MinVerDefaultPreReleaseIdentifiers>

src/libs/OpenApiGenerator.Core/Generation/Sources.Methods.cs

@@ -1,5 +1,3 @@
-using System.Net.Http;
-using Microsoft.OpenApi.Models;
 using OpenApiGenerator.Core.Extensions;
 using OpenApiGenerator.Core.Json;
 using OpenApiGenerator.Core.Models;
@@ -38,6 +36,10 @@ public static string GenerateConstructors(
 
 namespace {endPoint.Namespace}
 {{
+    /// <summary>
+    /// If no httpClient is provided, a new one will be created.
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
     public sealed partial class {endPoint.ClassName} : global::System.IDisposable
     {{
         private readonly global::System.Net.Http.HttpClient _httpClient;
@@ -47,9 +49,8 @@ public sealed partial class {endPoint.ClassName} : global::System.IDisposable
         /// If no httpClient is provided, a new one will be created.
         /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
         /// </summary>
-        /// <param name=""client""></param>
+        /// <param name=""httpClient""></param>
         /// <param name=""baseUri""></param>
-        /// <exception cref=""global::System.ArgumentNullException""></exception>
         public {endPoint.ClassName}(
             global::System.Net.Http.HttpClient? httpClient = null,
             global::System.Uri? baseUri = null)
@@ -89,6 +90,9 @@ public static string GenerateMethod(
         /// <summary>
         /// {endPoint.Summary}
         /// </summary>
+{endPoint.Properties.Where(x => x.ParameterLocation != null).Select(x => $@"
+        /// <param name=""{x.Name.ToParameterName()}""></param>").Inject()}
+        /// <param name=""request""></param>
         /// <param name=""cancellationToken"">The token to cancel the operation with</param>
         /// <exception cref=""global::System.InvalidOperationException""></exception>
         public async {taskType} {endPoint.MethodName}(

src/libs/OpenApiGenerator.Core/OpenApiGenerator.Core.csproj

@@ -5,6 +5,10 @@
     <NoWarn>$(NoWarn);CA1031;CA1307;CA1724;CA1056;CA1054;CA1865;CA1847</NoWarn>
   </PropertyGroup>
 
+  <ItemGroup Label="Global Usings">
+    <Using Include="System.Net.Http" />
+  </ItemGroup>
+
   <PropertyGroup Label="NuGet">
     <Description>Allows you to partially (for example, only models) or completely generate a native (without dependencies) C# client sdk according to the OpenAPI specification. Inspired by NSwag. Uses IncrementalGenerators for efficient generation and caching.</Description>
     <PackageTags>openapi;sdk;generator;source generator;dotnet;netstandard;netframework;native;nswag;incremental</PackageTags>

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/NewtonsoftJson/_#G.Api.EndPoints.Constructors.g.verified.cs

@@ -4,6 +4,10 @@
 
 namespace G
 {
+    /// <summary>
+    /// If no httpClient is provided, a new one will be created.
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
     public sealed partial class Api : global::System.IDisposable
     {
         private readonly global::System.Net.Http.HttpClient _httpClient;
@@ -13,9 +17,8 @@ public sealed partial class Api : global::System.IDisposable
         /// If no httpClient is provided, a new one will be created.
         /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
         /// </summary>
-        /// <param name="client"></param>
+        /// <param name="httpClient"></param>
         /// <param name="baseUri"></param>
-        /// <exception cref="global::System.ArgumentNullException"></exception>
         public Api(
             global::System.Net.Http.HttpClient? httpClient = null,
             global::System.Uri? baseUri = null)

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/NewtonsoftJson/_#G.Api.EndPoints.Create_run_runs_post.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Create Run
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task Create_run_runs_postAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/NewtonsoftJson/_#G.Api.EndPoints.Update_run_runs__run_id__patch.g.verified.cs

@@ -9,6 +9,8 @@ public partial class Api
         /// <summary>
         /// Update Run
         /// </summary>
+        /// <param name="runId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task Update_run_runs__run_id__patchAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/SystemTextJson/_#G.Api.EndPoints.Constructors.g.verified.cs

@@ -4,6 +4,10 @@
 
 namespace G
 {
+    /// <summary>
+    /// If no httpClient is provided, a new one will be created.
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
     public sealed partial class Api : global::System.IDisposable
     {
         private readonly global::System.Net.Http.HttpClient _httpClient;
@@ -13,9 +17,8 @@ public sealed partial class Api : global::System.IDisposable
         /// If no httpClient is provided, a new one will be created.
         /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
         /// </summary>
-        /// <param name="client"></param>
+        /// <param name="httpClient"></param>
         /// <param name="baseUri"></param>
-        /// <exception cref="global::System.ArgumentNullException"></exception>
         public Api(
             global::System.Net.Http.HttpClient? httpClient = null,
             global::System.Uri? baseUri = null)

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/SystemTextJson/_#G.Api.EndPoints.Create_run_runs_post.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Create Run
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task Create_run_runs_postAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/LangSmith/SystemTextJson/_#G.Api.EndPoints.Update_run_runs__run_id__patch.g.verified.cs

@@ -9,6 +9,8 @@ public partial class Api
         /// <summary>
         /// Update Run
         /// </summary>
+        /// <param name="runId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task Update_run_runs__run_id__patchAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.Constructors.g.verified.cs

@@ -4,6 +4,10 @@
 
 namespace G
 {
+    /// <summary>
+    /// If no httpClient is provided, a new one will be created.
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
     public sealed partial class Api : global::System.IDisposable
     {
         private readonly global::System.Net.Http.HttpClient _httpClient;
@@ -13,9 +17,8 @@ public sealed partial class Api : global::System.IDisposable
         /// If no httpClient is provided, a new one will be created.
         /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
         /// </summary>
-        /// <param name="client"></param>
+        /// <param name="httpClient"></param>
         /// <param name="baseUri"></param>
-        /// <exception cref="global::System.ArgumentNullException"></exception>
         public Api(
             global::System.Net.Http.HttpClient? httpClient = null,
             global::System.Uri? baseUri = null)

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.CopyModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Creates a model with another name from an existing model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task CopyModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.CreateModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Create a model from a Modelfile.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<CreateModelResponse> CreateModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.DeleteModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Delete a model and its data.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task DeleteModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.GenerateChatCompletion.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate the next message in a chat with a provided model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<GenerateChatCompletionResponse> GenerateChatCompletionAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.GenerateCompletion.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate a response for a given prompt with a provided model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<GenerateCompletionResponse> GenerateCompletionAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.GenerateEmbedding.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate embeddings from a model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<GenerateEmbeddingResponse> GenerateEmbeddingAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.ListModels.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// List models that are available locally.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<ModelsResponse> ListModelsAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.PullModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Download a model from the ollama library.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<PullModelResponse> PullModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.PushModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Upload a model to a model library.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<PushModelResponse> PushModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/NewtonsoftJson/_#G.Api.EndPoints.ShowModelInfo.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Show details about a model including modelfile, template, parameters, license, and system prompt.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<ModelInfo> ShowModelInfoAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.Constructors.g.verified.cs

@@ -4,6 +4,10 @@
 
 namespace G
 {
+    /// <summary>
+    /// If no httpClient is provided, a new one will be created.
+    /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
+    /// </summary>
     public sealed partial class Api : global::System.IDisposable
     {
         private readonly global::System.Net.Http.HttpClient _httpClient;
@@ -13,9 +17,8 @@ public sealed partial class Api : global::System.IDisposable
         /// If no httpClient is provided, a new one will be created.
         /// If no baseUri is provided, the default baseUri from OpenAPI spec will be used.
         /// </summary>
-        /// <param name="client"></param>
+        /// <param name="httpClient"></param>
         /// <param name="baseUri"></param>
-        /// <exception cref="global::System.ArgumentNullException"></exception>
         public Api(
             global::System.Net.Http.HttpClient? httpClient = null,
             global::System.Uri? baseUri = null)

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.CopyModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Creates a model with another name from an existing model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task CopyModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.CreateModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Create a model from a Modelfile.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<CreateModelResponse> CreateModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.DeleteModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Delete a model and its data.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task DeleteModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.GenerateChatCompletion.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate the next message in a chat with a provided model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<GenerateChatCompletionResponse> GenerateChatCompletionAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.GenerateCompletion.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate a response for a given prompt with a provided model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Collections.Generic.IAsyncEnumerable<GenerateCompletionResponse> GenerateCompletionAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.GenerateEmbedding.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Generate embeddings from a model.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<GenerateEmbeddingResponse> GenerateEmbeddingAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.ListModels.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// List models that are available locally.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<ModelsResponse> ListModelsAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.PullModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Download a model from the ollama library.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<PullModelResponse> PullModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.PushModel.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Upload a model to a model library.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<PushModelResponse> PushModelAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/Ollama/SystemTextJson/_#G.Api.EndPoints.ShowModelInfo.g.verified.cs

@@ -9,6 +9,7 @@ public partial class Api
         /// <summary>
         /// Show details about a model including modelfile, template, parameters, license, and system prompt.
         /// </summary>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<ModelInfo> ShowModelInfoAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/OpenAi/NewtonsoftJson/_#G.Api.EndPoints.CancelBatch.g.verified.cs

@@ -9,6 +9,8 @@ public partial class Api
         /// <summary>
         /// Cancels an in-progress batch.
         /// </summary>
+        /// <param name="batchId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<Batch> CancelBatchAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/OpenAi/NewtonsoftJson/_#G.Api.EndPoints.CancelFineTuningJob.g.verified.cs

@@ -9,6 +9,8 @@ public partial class Api
         /// <summary>
         /// Immediately cancel a fine-tune job.
         /// </summary>
+        /// <param name="fineTuningJobId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<FineTuningJob> CancelFineTuningJobAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/OpenAi/NewtonsoftJson/_#G.Api.EndPoints.CancelRun.g.verified.cs

@@ -9,6 +9,9 @@ public partial class Api
         /// <summary>
         /// Cancels a run that is `in_progress`.
         /// </summary>
+        /// <param name="threadId"></param>
+        /// <param name="runId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<RunObject> CancelRunAsync(

src/tests/OpenApiGenerator.SnapshotTests/Snapshots/OpenAi/NewtonsoftJson/_#G.Api.EndPoints.CancelVectorStoreFileBatch.g.verified.cs

@@ -9,6 +9,9 @@ public partial class Api
         /// <summary>
         /// Cancel a vector store file batch. This attempts to cancel the processing of files in this batch as soon as possible.
         /// </summary>
+        /// <param name="vectorStoreId"></param>
+        /// <param name="batchId"></param>
+        /// <param name="request"></param>
         /// <param name="cancellationToken">The token to cancel the operation with</param>
         /// <exception cref="global::System.InvalidOperationException"></exception>
         public async global::System.Threading.Tasks.Task<VectorStoreFileBatchObject> CancelVectorStoreFileBatchAsync(