Merge branch 'release/2.8.3'

Author: Jaben

.github/workflows/deploy.yml

@@ -61,10 +61,8 @@ jobs:
         GOTENBERG_PASSWORD: testpass
 
     - name: Pack
-      run: dotnet pack -c Release -p:PackageVersion=${{ steps.gitversion.outputs.FullSemVer }} -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg
-        
+      run: dotnet pack src/Gotenberg.Sharp.Api.Client/Gotenberg.Sharp.Api.Client.csproj -c Release -p:PackageVersion=${{ steps.gitversion.outputs.FullSemVer }} -p:IncludeSymbols=true -p:SymbolPackageFormat=snupkg
+
     - name: Publish
       if: github.event_name != 'pull_request' && (github.ref_name == 'master')
-      run: |
-        dotnet nuget push **/*.nupkg --source 'https://api.nuget.org/v3/index.json' -k ${{ secrets.NUGETKEY }} --skip-duplicate
-        dotnet nuget push **/*.snupkg --source 'https://api.nuget.org/v3/index.json' -k ${{ secrets.NUGETKEY }} --skip-duplicate        
+      run: dotnet nuget push src/Gotenberg.Sharp.Api.Client/bin/Release/*.nupkg --source 'https://api.nuget.org/v3/index.json' -k ${{ secrets.NUGETKEY }} --skip-duplicate        

CHANGES.MD

@@ -1,5 +1,30 @@
 # Release History
 
+## v2.8.3
+- **Configuration Improvements:**
+  - Added optional `Action<GotenbergSharpClientOptions>` parameter to `AddGotenbergSharpClient()` extension methods
+  - Allows programmatic configuration of options directly when registering the client
+  - Made `GotenbergSharpClientOptions` optional in DI - falls back to empty options if not configured
+  - Supports hybrid configuration (appsettings.json + programmatic overrides)
+  - Updated README with configuration examples (basic, programmatic, and hybrid)
+- **Documentation Improvements (PR #65):**
+  - Added comprehensive XML documentation to all public APIs
+  - Added Gotenberg documentation links to all client methods
+  - Enhanced IntelliSense with parameter details, valid value ranges, and usage notes
+  - Documented exception types with clear error handling guidance
+  - Updated README to highlight IntelliSense documentation features
+- **Examples & Quality (PR #66):**
+  - Converted LinqPad examples to .NET 8 console applications
+  - Fixed Footer/Header swap bug in examples
+  - Added proper resource disposal with CancellationToken.None to all CopyToAsync calls
+  - Added validation and null-forgiving operators to BasicAuth handler registration
+  - Fixed GitHub Actions build by adding example project build configurations
+- **Build & Packaging Fixes:**
+  - Fixed NuGet packaging to only publish the client library (not example projects)
+  - Replaced deprecated `PackageLicenseUrl` with `PackageLicenseExpression`
+  - Fixed GitHub Actions to only pack and push the Gotenberg.Sharp.Api.Client package
+  - Removed redundant symbol package push (handled automatically with main package)
+
 ## v2.8.1
 - Added strongly-typed cookie support for Gotenberg API
 - Added basic authentication support

README.md

@@ -3,11 +3,13 @@
 </h1>
 
 [![NuGet version](https://badge.fury.io/nu/Gotenberg.Sharp.Api.Client.svg)](https://badge.fury.io/nu/Gotenberg.Sharp.Api.Client)
-[![Downloads](https://img.shields.io/nuget/dt/Gotenberg.Sharp.API.Client.svg?logo=nuget&color=purple)](https://www.nuget.org/packages/Gotenberg.Sharp.API.Client) 
+[![Downloads](https://img.shields.io/nuget/dt/Gotenberg.Sharp.API.Client.svg?logo=nuget&color=purple)](https://www.nuget.org/packages/Gotenberg.Sharp.API.Client)
 ![Build status](https://github.com/ChangemakerStudios/GotenbergSharpApiClient/actions/workflows/deploy.yml/badge.svg)
 
 ⭐ For Gotenberg v7 & v8 ⭐
 
+📋 [Release History & Changes](CHANGES.MD)
+
 .NET C# Client for interacting with the [Gotenberg](https://gotenberg.dev/) v7 & v8 micro-service's API. [Gotenberg](https://github.com/gotenberg/gotenberg) is a [Docker-powered stateless API](https://hub.docker.com/r/gotenberg/gotenberg/) for converting & merging HTML, Markdown and Office documents to PDF. The client supports a configurable [Polly](http://www.thepollyproject.org/) **retry policy** with exponential backoff for handling transient exceptions.
 
 # Getting Started

examples/Directory.Build.props

@@ -4,6 +4,7 @@
     <TargetFramework>net8.0</TargetFramework>
     <ImplicitUsings>enable</ImplicitUsings>
     <Nullable>enable</Nullable>
+    <IsPackable>false</IsPackable>
   </PropertyGroup>
 
   <ItemGroup>

src/Gotenberg.Sharp.Api.Client/Gotenberg.Sharp.Api.Client.csproj

@@ -14,14 +14,14 @@
 	</PropertyGroup>
 
 	<PropertyGroup Label="PackageInfo">
-		<Version>2.8.2</Version>
+		<Version>2.8.3</Version>
 		<PackageTags>Gotenberg pdf C# API client unoconv</PackageTags>
 		<Description>
 		C# API client for interacting with the Gotenberg v7 &amp; v8 micro-service's API, a docker-powered stateless API for converting &amp; merging HTML, Markdown and Office documents to PDF. The client supports a configurable Polly retry policy with exponential back-off for handling transient exceptions.
 		</Description>
 		<IncludeSymbols>True</IncludeSymbols>
 		<PackageReleaseNotes>
-			v2.8.2 - Added optional Action&lt;GotenbergSharpClientOptions&gt; parameter to AddGotenbergSharpClient for programmatic configuration. Options now optional in DI.
+			v2.8.3 - Added programmatic configuration support. Comprehensive documentation improvements. Fixed NuGet packaging issues. See CHANGES.MD for full details.
 			v2.8.1 - Added strongly-typed cookie support. Added basic authentication support. Added SinglePage page property. Fixed margins bug. Project restructure (moved /lib to /src).
 			v2.8 - Improving handling of PDF formatting and added flatten support.
 			v2.7 - Fixes issue with "Inches".
@@ -33,7 +33,7 @@
 			v2.1 - Added Trace Support. Fixed extra webhook header support.
 			v2.0 - Upgraded to support Gotenberg v7 -- this version no longer works with Gotenberg v6.
 	    </PackageReleaseNotes>
-		<PackageLicenseUrl>http://www.apache.org/licenses/LICENSE-2.0</PackageLicenseUrl>
+		<PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
 		<PackageProjectUrl>https://github.com/ChangemakerStudios/GotenbergSharpApiClient</PackageProjectUrl>
 		<PackageIconUrl>https://raw.githubusercontent.com/ChangemakerStudios/GotenbergSharpApiClient/master/resources/gotenberg-sharp-client.png</PackageIconUrl>
 		<PackageIcon>gotenberg-sharp-client.png</PackageIcon>