Releasing v2.6

Author: Jaben

lib/Domain/Dimensions/Dimension.cs

@@ -20,6 +20,37 @@
 
 namespace Gotenberg.Sharp.API.Client.Domain.Dimensions;
 
+/// <summary>
+/// Represents a numeric dimension and its corresponding unit type (e.g., points, pixels, inches, etc.).
+/// This class is primarily used to specify size values like page dimensions and margins.
+/// 
+/// <para>
+/// Example usage:
+/// <code>
+/// var dim1 = Dimension.Parse("200px");       // Parses from string
+/// var dim2 = Dimension.FromInches(8.5);      // Creates a dimension in inches
+/// var dim3 = new Dimension(21.0, DimensionUnitType.Centimeters);
+/// </code>
+/// </para>
+/// 
+/// <para>
+/// Dimensions are immutable, meaning both <see cref="Value"/> and <see cref="UnitType"/>
+/// cannot be changed after instantiation. The class implements <see cref="IEquatable{Dimension}"/>
+/// to facilitate comparisons.
+/// </para>
+/// 
+/// <para>
+/// Supported unit strings when parsing are: "pt", "px", "in", "mm", "cm", and "pc".
+/// An <see cref="ArgumentException"/> will be thrown if an unsupported or malformed dimension string is provided.
+/// </para>
+/// 
+/// <para>
+/// Use the static convenience methods (e.g., <see cref="FromPoints(double)"/>,
+/// <see cref="FromPixels(double)"/>, <see cref="FromInches(double)"/>, etc.) to create instances
+/// in a specific unit type. The <see cref="Parse(string)"/> method can be used to parse a dimension
+/// string directly, ensuring validation of both the numeric value and the unit type.
+/// </para>
+/// </summary>
 public sealed class Dimension(double value, DimensionUnitType unitType) : IEquatable<Dimension?>
 {
     private static readonly Regex ValidDimensionRegex =

lib/Gotenberg.Sharp.Api.Client.csproj

@@ -14,13 +14,14 @@
 	</PropertyGroup>
 
 	<PropertyGroup Label="PackageInfo">
-		<PackageVersion>2.5</PackageVersion>
+		<PackageVersion>2.6</PackageVersion>
 		<PackageTags>Gotenberg pdf C# ApiClient 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.6 - Updated office Extensions. Added document metadata support. Add Dimension.FromUnit() support for dimensional values.
 			v2.5 - Renamed "Dimentions" to "PageProperties". Added support for 'GenerateDocumentOutline' and 'OmitBackground.'
 			v2.4 - Updated dependencies. Removed Annotations. Add support for PDF/UA form field. Thank you for the PR @lennartb-!
 			v2.3 - Added Convert Page 'ExportFormFields' flag support (Gotenberg v8.3+ Only). Added .NET 8 target.
@@ -41,6 +42,7 @@
 		<EmbedUntrackedSources>true</EmbedUntrackedSources>
 		<IncludeSymbols>true</IncludeSymbols>
 		<SymbolPackageFormat>snupkg</SymbolPackageFormat>
+		<GenerateDocumentationFile>true</GenerateDocumentationFile>
 	</PropertyGroup>
 
 	<ItemGroup>