fix: grammar, TOC typo, and outdated API references in docs

Agent-Logs-Url: https://github.com/petesramek/polyline-algorithm-csharp/sessions/6bb4cacd-08ac-42d9-825f-139d0b64f725

Co-authored-by: petesramek <2333452+petesramek@users.noreply.github.com>

Author: Copilot

api-reference/guide/advanced-scenarios.md

@@ -120,7 +120,7 @@ var builder = WebApplication.CreateBuilder(args);
 
 builder.Services.AddMyPolylineEncoderDecoder(
     PolylineEncodingOptionsBuilder.Create()
-        .SetMaxBufferSize(10000)
+        .WithStackAllocLimit(1024)
         .Build()
 );
 
@@ -145,7 +145,7 @@ builder.Services.AddMyPolylineEncoderDecoder(
 ## Integration Guidance
 
 - **Batch or incremental processing:**  
-  For large datasets, control buffer sizes via `PolylineEncodingOptions`.
+  For large datasets, control the stack allocation limit via `PolylineEncodingOptions.StackAllocLimit`.
 - **Thread safety:**  
   Default encoders/decoders are stateless and thread-safe. If extending for mutable types, ensure synchronization.
 - **Logging:**  

api-reference/guide/configuration.md

@@ -8,13 +8,13 @@ PolylineAlgorithm offers flexible configuration for encoding and decoding polyli
 
 Most configuration is handled via the `PolylineEncodingOptions` object, which you can build using the fluent `PolylineEncodingOptionsBuilder`.
 
-### Example: Customizing Buffer Size
+### Example: Customizing Stack Alloc Limit
 
 ```csharp
 using PolylineAlgorithm;
 
 var options = PolylineEncodingOptionsBuilder.Create()
-    .SetMaxBufferSize(10000) // Set custom buffer size
+    .WithStackAllocLimit(1024) // Set stack allocation threshold (bytes)
     .Build();
 
 var encoder = new PolylineEncoder(options);
@@ -47,7 +47,7 @@ For custom validation (e.g., for custom coordinate types), extend the provided i
 
 When using `PolylineEncodingOptionsBuilder`, you may set:
 
-- **Buffer sizes:** Configure allocation for large or streaming polylines
+- **Stack alloc limit:** Configure the threshold below which buffers are stack-allocated vs. rented from `ArrayPool<char>`
 - **Logging hooks:** Integrate your logger for troubleshooting/instrumentation
 - **(Future)** Custom precision, additional metadata (as needed)
 
@@ -59,8 +59,8 @@ See the XML API documentation for all available builder methods.
 
 ```csharp
 var options = PolylineEncodingOptionsBuilder.Create()
-    .SetMaxBufferSize(5000)
-    // .EnableLogging(myLogger) // (if applicable)
+    .WithStackAllocLimit(512)
+    .WithLoggerFactory(myLoggerFactory)
     .Build();
 
 var encoder = new PolylineEncoder(options);

api-reference/guide/toc.yml

@@ -5,7 +5,7 @@
 - name: Configuration
   href: configuration.md
 - name: Advanced Scenarios
-  href: advanced-scenarions.md
+  href: advanced-scenarios.md
 - name: Sample
   href: sample.md
 - name: FAQ

src/PolylineAlgorithm/Properties/ExceptionMessageResource.Designer.cs

@@ -124,7 +124,7 @@
     <value>Polyline is malformed at position {0}.</value>
   </data>
   <data name="PolylineCannotBeShorterThanFormat" xml:space="preserve">
-    <value>Argument cannot be shorten than {1} characters. Value: {0}.</value>
+    <value>Argument cannot be shorter than {1} characters. Value: {0}.</value>
   </data>
   <data name="ArgumentValueMustBeFiniteNumber" xml:space="preserve">
     <value>Value must be a finite number.</value>